Convertir PHP a PDF

Se necesita una copia de diseño fijo cuando una página generada por PHP debe imprimirse, enviarse, compartirse o archivarse. El código fuente de PHP debe ejecutarse para producir la página o formatearse como código; un conversor de archivos normal no lo representa directamente como un PDF terminado.

Qué es el formato PHP

PHP es un lenguaje de scripting del lado del servidor que utilizan los desarrolladores y administradores web para generar páginas dinámicas, formularios, facturas, informes y respuestas de API. Un archivo .php contiene código fuente, normalmente combinado con HTML, CSS, SQL o marcado de plantillas; PHP es un lenguaje de programación, no un formato de documento.

Un servidor web habilitado para PHP interpreta el archivo y devuelve el resultado generado, normalmente HTML, a un navegador. Abrir un archivo .php desde un administrador de archivos no ejecuta su código del lado del servidor: puede mostrar el texto fuente o no cargarse, según el sistema operativo y la aplicación.

Qué es el formato PDF

PDF es un formato de documento de diseño fijo que conserva las dimensiones de página, las fuentes, las imágenes, el espaciado y la paginación en distintos sistemas operativos y dispositivos. Los destinatarios pueden imprimirlo o verlo sin PHP, un servidor web ni la aplicación que creó la página original.

PDF es adecuado para facturas, envíos oficiales, archivos adjuntos de correo electrónico y copias de archivo. Normalmente no está pensado para editarse como un archivo de procesamiento de textos, y la conversión no garantiza un archivo más pequeño; las fuentes y las imágenes incrustadas pueden aumentar su tamaño.

Convertir la página PHP generada

Utilice este método cuando el PDF requerido sea un informe, recibo, formulario u otra página producida por el script.

1. Instale PHP y, si es necesario, un paquete de servidor local como XAMPP, Laragon o MAMP. El servidor integrado de PHP es suficiente para muchos proyectos autónomos.
2. Coloque el proyecto en su directorio de documentos y configure las bases de datos, variables de entorno, extensiones, archivos incluidos y carpetas con permisos de escritura necesarios.
3. Desde el directorio de proyecto o document-root correspondiente, ejecute php -S localhost:8000. El comando inicia un servidor de desarrollo; no es un despliegue de producción.
4. Abra la dirección correspondiente, como http://localhost:8000/report.php, en Chrome, Edge o Firefox y compruebe que la página contiene los datos esperados.
5. Utilice Print → Save as PDF en el navegador. Seleccione el tamaño de papel y los márgenes necesarios, habilite los gráficos de fondo cuando el diseño los utilice y revise los saltos de página, las imágenes, los encabezados y los pies de página en la vista previa de impresión.

Para obtener resultados del lado del servidor de forma repetible, utilice un flujo de trabajo de Chromium sin interfaz gráfica con Playwright o Puppeteer y su función PDF. Proporcione el mismo CSS de impresión, viewport, formato de papel, márgenes y condiciones de carga de página que se utilizan en producción; espere a las solicitudes de red y al contenido representado por JavaScript antes de generar el PDF.

Si la página ya está disponible como HTML, servicios en línea reconocidos como PDFCrowd o CloudConvert pueden proporcionar conversión de HTML a PDF. Cargue el HTML generado en lugar del archivo .php original: estos servicios generalmente no ejecutan PHP arbitrario, y es posible que no tengan acceso a hojas de estilo externas, fuentes, imágenes, sesiones ni datos autenticados.

Convertir el código fuente de PHP

Utilice este método cuando el propio código fuente sea el documento, por ejemplo, para una revisión de código, material de formación o un registro en papel.

1. Abra el archivo en un editor de código como PhpStorm, Notepad++ o Visual Studio Code y habilite el resaltado de sintaxis de PHP.
2. Establezca una fuente monoespaciada legible, márgenes adecuados, ajuste de línea y números de línea opcionales. Deshabilite el ajuste de línea si conservar las líneas exactas del código fuente es más importante que adaptarlo a la página.
3. Imprima desde un editor compatible con la impresión, como Notepad++ o PhpStorm, y elija una impresora PDF del sistema: Microsoft Print to PDF en Windows o Save as PDF en el cuadro de diálogo de impresión de macOS. Visual Studio Code puede requerir una extensión de impresión o una exportación HTML intermedia.

Para generar PDF del código fuente de forma automatizada, aplique el resaltado de sintaxis con Pygments o un formateador similar, exporte el resultado como HTML e imprima ese HTML mediante Chromium. Esto documenta el texto fuente; no ejecuta PHP ni captura la página generada por el script.

Generar PDF dentro de una aplicación PHP

Para facturas, informes o formularios recurrentes, una aplicación PHP puede crear PDF a partir de plantillas con bibliotecas como Dompdf, mPDF o TCPDF. Esto es generación de PDF, no conversión de archivos, y requiere código, instalación de dependencias, preparación de plantillas y pruebas de compatibilidad con CSS.

Limitaciones de calidad y seguridad

La autenticación, los resultados de bases de datos, las extensiones de PHP que falten, los permisos, las rutas relativas, el CSS externo, las fuentes web, JavaScript y el CSS de impresión del navegador pueden cambiar el resultado representado. Realice pruebas con datos representativos, verifique las imágenes y los saltos de página, y compare el PDF con la página de la URL prevista.

No cargue código fuente de PHP confidencial, credenciales, datos de clientes ni páginas generadas privadas en un conversor en línea. Un navegador local, un proceso de Chromium sin interfaz gráfica o una biblioteca PDF de PHP evita exponer esos archivos y permite acceder a las dependencias locales. Elimine los secretos de los PDF del código fuente y compruebe que los PDF generados no contengan metadatos no deseados ni datos ocultos de formularios.