En este artículo haremos un repaso a algunas de las funciones más importantes que nos podemos encontrar en la librería FPDF de PHP.
En el primer articulo sobre FPDF colocábamos un ejemplo muy sencillo de cómo crear un archivo pdf a partir de PHP. Bien pues ahora vamos a ir viendo una a una las funciones que aparecían en dicho ejemplo.
<?php
require('fpdf.php');
$pdf=new FPDF();
$pdf->AddPage();
$pdf->SetFont('Arial','B',16);
$pdf->Cell(40,10,'¡Hola, Mundo!');
$pdf->Output();
?>
FPDF()
Vamos a empezar con la clase constructor FPDF() que nos permite crear el documento pdf y darle un formato. Tenemos que tener en cuenta que los parámetros que le pasemos se usarán en todos los métodos. Su sintaxis es la siguiente:
FPDF([string orientación [, string unidad [, mixed formato]]);
- orientación es la forma de colocación de la página, es decir, debemos indicar si es normal o apaisada. El valor por defecto P es normal. El valor para apaisada es "L"
- unidad es la medida de usuario y sus posibles valores son: "pt" punto, "mm" milímetro, "cm" centímetro e "in" pulgada. El valor por defecto es el "mm"
- formato de la página. Puede tener los siguientes valores: A3, A4, A5, Letter y Legal. El valor por defecto es A4
Un ejemplo sería el siguiente:
$pdf=new FPDF('L','pt','Legal');
AddPage()
Esta función nos añade una página nueva al documento pdf. Como parámetros tan solo tiene la orientación y el formato, el resto de características las coge por defecto del constructor.
Su sintaxis es la siguiente:
$pdf->AddPage([string orientacion[,mixed formato]]);
Los parámetros orientación y formato son iguales que en FPDF(). Si no le pasas parámetros cogerá automáticamente los del constructor.
SetFont
Es la función que nos permite establecer el formato de la fuente utilizada en el archivo pdf. Es obligatorio llamar a esta función al inicio de la creación del archivo ya que sino el documento no sería valido.
Si queremos añadir un tipo de fuente que no está en el standar debemos utilizar la función AddFont(); que veremos más adelante.
La sintaxis de SetFont es la siguiente:
SetFont(string familia[, string estilo [, float size]]);
- familia: familia de fuente que pueden ser las standars(Courier,Helvetica o Arial, Times, Symbol,ZapfDingbats) o añadir una mediante AddFont();
- estilo: estilo de la fuente que puede ser regular, negrita "B", italica "I" y subindice "U".
- size: tamaño de la fuente en puntos. Su valor por defecto es 12.
Un ejemplo seria el siguiente:
SetFont('Helvetica','I',13);
Cell
Esta función nos imprime una celda donde vamos a imprimir nuestro texto. Tiene bordes opcionales y color de fondo. En esta celda podemos colocar el texto alineado o centrado.Su sintaxis es la siguiente:
Cell(float w [, float h [, string texto [, mixed borde [, int ln [, string align [, boolean fill [, mixed link]]]]]]])
- w: ancho de la celda. Si ponemos 0 la celda se extiende hasta el margen derecho.
- H: alto de la celda.
- Texto: el texto que le vamos a añadir.
- Borde: nos dice si van a ser visibles o no. si es 0 no serán visibles, si es 1 se verán los bordes.
- Ln: nos dice donde se empezara a escribir después de llamar a esta función. Siendo 0 a la derecha, 1 al comienzo de la siguiente línea, 2 debajo.
- Align: para alinear el texto. L alineado a la izquierda, C centrado y R alineado a la derecha.
- Fill: nos dice si el fondo de la celda va a ir con color o no. los valores son True o False
Un ejemplo sería el siguiente:
$pdf->Cell(10,10,'Estamos viendo',1,1,'C');
Output()
Nos envía el documento al navegador, a un fichero local o a una cadena. Podemos abrirlo en un cuadro de diálogo o prepararlo para una descarga.Su sintaxis es la siguiente:
string Output([string nombre, string destino])
- nombre: damos nombre al fichero, si no se indica lo llama por defecto doc.pdf
- destino: destino de envío en el documento. I envía el fichero al navegador con la opción de guardar como..., D envía el documento al navegador preparado para la descarga, F guarda el fichero en un archivo local, S devuelve el documento como una cadena.
Un ejemplo seria el siguiente:
$fpdf->Output('prueba','I');
Estas son solo algunas de las funciones más importantes de la librería FPDF. No te preocupes que no hayamos visto ejemplos más completos, porque las vamos a estar usando en muchos de los códigos que veremos a continuación en el Manual de FPDF para PHP.
En la siguiente entrega vamos a abordar la creación de bloques de cabecera y pie para nuestros documentos PDF.