TCPDF - Completa librería para crear documentos PDF en tu aplicación o sitio web en PHP. Ideal también para generar reportes en PHP y base de datos.

TCPDF es una excelente opción para crear archivos PDFs mediante PHP.

Este script además de ser completamente gratuito, es software libre, y utilizado por millones de personas hoy en día en sus aplicaciones y sitios web.

Indice del contenido:

1. Descripción general del script
2. Instalación
   1. Instalación de la clase PHP en el servidor web.
   2. Parámetros y opciones de configuración.
   3. Configuraciones luego de la instalación
3. Otras características y opciones de la librería PHP
4. Ejemplos para crear los documentos PDF

 

1 - Descripción general del script.

La clase es un proyecto iniciado en el año 2002 y con frecuencia, gracias al aporte de muchos otros programadores del mundo, se actualizan nuevas versiones con mas funciones y características, además de corregir bugs y fallos.

Con la librería se pueden crear documentos PDF en cualquier aplicación web basada en PHP, e incluye muchas opciones .. por ejemplo contiene métodos y funciones para justificar el texto del documento, manipular los encabezados y numeración automática de las páginas, soporte y generación de códigos de barras entre varias otras.

Otra ventaja es que no requiere de componentes y librerías externas para poder instalarla. Simplemente con tener soporte PHP en nuestro servidor web podremos utilizarla para generar los documentos PDF.

Pero sin lugar a duda, lo mas interesante, es que contiene mas de 60 ejemplos y una amplia documentación, que te ahorrará mucho tiempo de trabajo y programación para generarlos. Los mismos los puedes acceder o bien desde el sitio web del autor, o junto a los archivos fuentes ( en las carpetas de ejemplos y manuales que se incluye junto al fichero ZIP).

2.1 - Instalación de la clase PHP en el servidor web.

Nota: esto es una breve descripción del proceso de instalación, para ver más información sobre la configuración y puesta en marcha del script, puedes leer el archivo de documentación.

Subir los archivos y modificar permisos: Asumiendo que ya tenemos listo el acceso FTP para poder subir los archivos a una ubicación del servidor web ( por ejemplo mediante el programa FileZilla), el primer paso consiste en cambiar o modificar los permisos a los archivos 777.

2.2 - Parámetros y opciones de configuración.

Luego el segundo paso es modificar algunos parámetros y opciones que necesita el script para poder funcionar. Esto se realiza editando el archivo tcpdf_config ubicado en la carpeta Config. Este archivo fuente PHP permite entre otras cosas definir:

• El directorio que utiliza la clase para almacenar las imágenes.
• Definir el directorio de caché para los archivos temporales.
• El formato de página o papel que se va a utilizar para los documentos PDF, por defecto se utiliza una hoja de tipo A4.
• La orientación utilizada para la página: portrait, landscape
• Definir el nombre del autor del documento PDF.
• El título o cabecera del documento.
• El logo.
• La escala o unidad de medida para el mismo: Milimetro, centímetros, inch etc ..
• Los márgenes de los encabezados, pie y documento.
• La fuente por defecto que se utilizará para el título, el texto, el pie etc ..
• Otras propiedades de fuente: Tamaño, color etc ..

2.3 - Configuraciones luego de la instalación.

Luego de instalar y configurar el archivo anterior, se deberán realizar algunas acciones post instalación, que son las siguientes:

• Cambiar permisos: Establecer en modo lectura a la carpeta TCPDF ( chmod -R 644 )
• modificar los permisos de las carpetas que necesitan de escritura y creación de archivos ( Chmod 666 ) para las carpetas de imagenes ( image) y de archivos temporales ( caché )

Hecho esto, se podremos abrir una ventana del navegador web, y ejecutar uno de los ejemplos para generar los PDF y verificar que todo funciona de forma correcta.

Para ejecutar un ejemplo, escribe en la barra del navegador lo siguiente : http://www.sitio web.com/tcpdf/example/example_001.php.

3 - Otras características y opciones de la clase PHP son:

• Soporte para encriptar los documentos.
• Soporte para impresión de código de barras : ANSI MH10.8M-1983, CODE 39, CODE 93, USS-93, Estándar 2 de 5, Interleaved 2 de 5, CODE 128 A/B/C, USD-3, 2 y 5 dígitos UPC-Based Extention, EAN 8, EAN 13, UPC-A, UPC-E, MSI, POSTNET, PLANET, RMS4CC (Royal Mail 4-state Customer Code), PHARMACODE, PHARMACODE TWO-TRACKS, CBC (Customer Bar Code), KIX, Intelligent Mail Barcode, Onecode, USPS-B-3200, CODABAR, CODE 11
• Incluye métodos para imprimir, por ejemplo el contenido de una tabla.
• Soporta en forma nativa archivos de imagen JPG y PNG, y muchos otros formatos gráficos utilizando el programa ImagMagick.
• Soporte para inclusión de enlaces y archivos adjuntos.
• Compresión ( Mediante la extensión zLib)
• La clase contiene métodos o funciones para generar el código como XHTML + CSS + Javascript y formularios.
• Uso de fuentes: TrueType, OpenType, Type1, CID-0, TrueTypeUnicode y OpenTypeUnicode.
• Soporta todos los formatos de papel estandar y otros tipos personalizados: por ejemplo A4, oficio, carta etc ..
• Mover y eliminar páginas.
• Numeración automática y crear grupos de páginas.
• Utilizar plantillas ( xObject)
• Crear anotaciones de texto, marcas de agua, etc ..
• Renderizar texto.
• Métodos para realizar configuraciones y dar formato a la fuente.
• Muchas otras.

4 - Ejemplos para crear los documentos PDF.

En este enlace web puedes ver la lista de ejemplos ( mas de 60 actualmente ). Cada uno de ellos contiene dos enlaces: Uno para visualizar y obtener el código PHP y otro linK para ver el archivo PDF.

Ente la lista de ejemplos podrás encontrar :

1. Primer ejemplo utilizando la librería TCPDF escribiendo un texto con los métodos: WriteHTMLCell, MultiCell, WriteHTML, Cell y la función Text.
2. Escribir un título o header con las funciones setPrintHeader and setPtintFooter. Al utilizar estos métodos no se utiliza la configuración por defecto para los encabezados y pie de página.
3. Crear encabezados y pie de página personalizados ( Métodos Header y Foother)
4. Como escribir contenido HTML en el PDF.
5. Como crear una tabla de contenidos o índice con marcadores mediante el método Bookmarks.
6. Crear una tabla y aplicar colores a las celdas y encabezados de la misma.
7. Como encriptar y proteger documentos PDF utilizando el método setProtection.
8. Justificar texto y otro contenido HTML.
9. Combinar imágenes y texto y aplicar transparencia a los gráficos.
10. Realizar configuraciones avanzadas para la página.
11. Generar tabla de contenidos en HTML.
12. Alineamiento vertical de celda.
13. Ejemplo de formulario en HHTML.
14. Ejemplo de uso de funciones Javascript
15. Muchos otros.

Imágenes de los ejemplos:

Crear un simple PDF con encabezado y pie de página

Crear un documento con celdas y aplicar formato

Crear tabla con registros y aplicar formato a las filas y columnas ( color de celdas, texto, encabezado de columnas etc ..)

Establecer Imagen de fondo

Crear un índice para el contenido.

Justificar texto

Generación de gráficos estadísticos - gráfico circular 2D

Crear código de barras

Texto en varias columnas

Utilizar funciones y métodos gráficos para dibujar líneas, círculos, curvas, rectángulos etc ..

 

Lenguaje: PHP

Sistemas operativos: Windows, Linux, Mac, Solaris, FreeBSD

No hay videos disponibles para esta publicación.

Algunas mejoras en la última versión son:

• Actualización en el método Rect para imprimir los bordes correctamente.
• Bug solucionado en el método función AddTTFFont
• Mejoras en la conversión de tamaño de fuente en archivos HTML y CSS.
• Error solucionado en la ruta de la fuente utilizada por defecto.
• Error solucionado en la llamada a la función $uni_type call del archivo tcpdf.php
• Actualización importante. en la nueva versión del script, no es compatible con PHP4
• Mejoras en el método Image.