Guía de comparación y despliegue

¿No estás seguro de qué paquetes necesitas? Usa el asistente interactivo a continuación, o explora los escenarios de despliegue y la matriz de decisión para encontrar tu configuración ideal.

Encuentra tu configuración perfecta

1

Tipo de proyecto

2

Versión de PHP

3

Framework

4

HTML a PDF

5

Funciones Pro

Tipo de proyecto

Genera tu configuración

Generador de configuración

Selecciona tus paquetes y opciones para generar archivos de configuración listos para usar.

Paquetes

CoreArtisanProLaravelSymfonyCodeIgniterAdaptation

Core siempre se incluye

Opciones de Docker

Imagen base

Fuentes CJKInstalar Noto Sans CJK para soporte de chino, japonés y coreanoRoadRunnerAgregar RoadRunner para servicio HTTP con worker persistente

Código generado

composer require yeeefang/tcpdf-next

Escenarios de despliegue

Diferentes entornos de hosting tienen diferentes capacidades. Esto es lo que funciona mejor para cada uno:

🏠

Hosting Compartido

Rendimiento

Paquetes Recomendados

Core

Acceso PHP limitado, sin shell. Solo Core con fuentes básicas. Sin Chrome/RoadRunner.

🖥

VPS (PHP-FPM)

Rendimiento

Paquetes Recomendados

Core Artisan Laravel

Control total del servidor. Instalar Chrome para HTML→PDF. Adecuado para la mayoría de apps.

🖥

VPS + RoadRunner

RoadRunner

Rendimiento

Paquetes Recomendados

Core Artisan Laravel

Worker persistente elimina arranques en frío. Rendimiento 3-7x mayor.

⚙

Servidor Dedicado

Rendimiento

Paquetes Recomendados

Core Artisan Pro Laravel

Recursos completos. Ideal para funciones Pro (PAdES, PDF/A-4, HSM).

⚙

Dedicado + RoadRunner

RoadRunner

Rendimiento

Paquetes Recomendados

Core Artisan Pro Laravel

Máximo rendimiento. 9,000+ docs/s con 4 workers.

☸

Kubernetes / Docker

RoadRunner

Rendimiento

Paquetes Recomendados

Core Artisan Pro Symfony

Escalado horizontal. RoadRunner como proceso worker. Nivel producción.

Rendimiento: PHP-FPM estándar vs RoadRunner

RoadRunner mantiene tu aplicación PHP en memoria como un worker persistente, eliminando arranques en frío e incrementando dramáticamente el throughput.

PHP-FPM estándar vs RoadRunner

▲ Mayor es mejor

PHP-FPM RoadRunner

Documento simple

390 docs/s

2,605 docs/s

6.7x más rápido

Factura

294 docs/s

1,960 docs/s

6.7x más rápido

Informe de 100 páginas

14 docs/s

98 docs/s

7.0x más rápido

4 Workers

1,500 docs/s

9,221 docs/s

6.1x más rápido

PHP 8.5.3 + OPcache + JIT · Docker 4 CPUs / 16 GB · i9-13900K · Mediana de 20 ejecuciones

Cuándo usar RoadRunner

RoadRunner se recomienda cuando necesitas alto throughput (cientos de PDFs por minuto) o baja latencia (tiempos de respuesta sub-milisegundo). Para aplicaciones web típicas que generan unos pocos PDFs por request, PHP-FPM estándar es perfectamente adecuado.

Matriz de decisión por caso de uso

¿Qué paquetes deberías instalar para tu caso de uso específico?

\u{2705} Recomendado\u{26AA} Opcional— N/A

Caso de Uso	Core	Artisan	Pro	Laravel	Symfony	CI4	Adaptation
Generación de Facturas y Reportes	✅	⚪	⚪	⚪	⚪	⚪	—
E-commerce (HTML→PDF)	✅	✅	⚪	⚪	⚪	⚪	—
Documentos Accesibles (PDF/UA)	✅	—	✅	⚪	⚪	⚪	—
Firmas Digitales (PAdES)	✅	—	✅	⚪	⚪	⚪	—
Migración desde TCPDF Legacy	✅	⚪	—	⚪	⚪	⚪	✅
API de Alto Rendimiento	✅	⚪	⚪	✅	✅	⚪	—
Cumplimiento de Archivado (PDF/A-4)	✅	—	✅	⚪	⚪	⚪	—
Documentos con Códigos de Barras	✅	—	⚪	⚪	⚪	⚪	—

Compatibilidad de paquetes

La mayoría de los paquetes funcionan juntos sin problemas, con una excepción:

Combinación	Compatible	Notas
Core + Cualquier paquete	Sí	Core siempre es requerido
Artisan + Cualquier framework	Sí	Chrome CDP funciona con todos los frameworks
Pro + Laravel/Symfony/CI	Sí	Funcionalidades enterprise completas en cualquier framework
Pro + Adaptation	No	Adaptation envuelve la API legacy de TCPDF; Pro extiende la API moderna de TCPDF-Next. Elige un enfoque.
Adaptation + Framework	Sí	Usa Adaptation para migrar código legacy dentro de tu framework

Consideraciones CJK y fuentes

Las 14 fuentes básicas integradas (Helvetica, Times, Courier, etc.) solo soportan caracteres latinos. Si tus documentos necesitan texto en chino, japonés o coreano, debes:

1. Embeber fuentes TrueType — Usa setFont() con una fuente TTF que soporte tu conjunto de caracteres
2. Configurar rutas de fuentes — Establece la variable de entorno TCPDF_FONTS_DIR o usa la API de configuración
3. Considerar el tamaño de archivo — Las fuentes CJK típicamente pesan 5-15 MB cada una; usa subsetting de fuentes para reducir el tamaño del PDF

// Ejemplo: Usando una fuente CJK
$pdf = Document::createStandalone()
    ->addPage()
    ->setFont('/path/to/NotoSansCJK-Regular.ttf', '', 12)
    ->cell(0, 10, '你好世界 こんにちは 안녕하세요');

Fuentes CJK recomendadas

• Noto Sans CJK — Familia de fuentes CJK de código abierto de Google (gratuita)
• Source Han Sans — Equivalente de Adobe (gratuita)
• Ambas soportan chino simplificado, chino tradicional, japonés y coreano en un solo archivo de fuente.

Limitaciones del hosting compartido

En hosting compartido, típicamente no puedes:

• Instalar Chrome/Chromium (sin paquete Artisan)
• Ejecutar procesos de larga duración (sin RoadRunner)
• Instalar extensiones PHP (limitado a las proporcionadas)

Configuración recomendada para hosting compartido:

composer require yeeefang/tcpdf-next

Usa solo Core con el parser HTML integrado para necesidades básicas de HTML a PDF. Para renderizado HTML pixel-perfect, considera actualizar a un VPS.

Próximos pasos

• Primeros pasos — Instala y crea tu primer PDF
• Guía de instalación — Instalación detallada para todos los paquetes
• Benchmarks — Datos completos de comparación de rendimiento
• Migración desde TCPDF — Guía de migración paso a paso