pdf archivos - KumbiaPHP Framework PHP en español https://kumbiaphp.com/blog/tag/pdf/ Web & app MVC PHP framework Fri, 27 Jan 2023 20:05:56 +0000 es hourly 1 https://wordpress.org/?v=6.8.3 https://kumbiaphp.com/blog/wp-content/uploads/2016/01/250-150x150.png pdf archivos - KumbiaPHP Framework PHP en español https://kumbiaphp.com/blog/tag/pdf/ 32 32 123854898 Exportar tabla HTML a PDF https://kumbiaphp.com/blog/2019/04/29/exportar-tabla-html-a-pdf/?utm_source=rss&utm_medium=rss&utm_campaign=exportar-tabla-html-a-pdf https://kumbiaphp.com/blog/2019/04/29/exportar-tabla-html-a-pdf/#respond Sun, 28 Apr 2019 23:29:56 +0000 https://www.kumbiaphp.com/blog/?p=2078 En esta segunda parte veremos como exportar una tabla HTML a PDF usando la librería mPDF. Si no has…

La entrada Exportar tabla HTML a PDF se publicó primero en KumbiaPHP Framework PHP en español.

]]> En esta segunda parte veremos como exportar una tabla HTML a PDF usando la librería mPDF. Si no has visto la primera parte este es el primer artículo: Crear PDF usando HTML donde aprendimos a crear un PDF usando partials y funciones en un modelo.

[Actualización: Abril 2020] Hemos creado un nuevo repositorio llamado Sandbox en Github donde van a estar todos los ejemplos y que podrán visualizar en vivo en la página KumbiaPHP Framework Examples por lo tanto el código se ha mejorado y los links han cambiado.

Template PDF

Un template permite ahorrar código que se repite en la vistas, permitiendo así un fácil mantenimiento y separación del contenido. Realizará la carga de librería, la cabecera y el pié de página y por supuesto el contenido que queremos mostrar.

Para los que aun no han visto el tema de templates en KumbiaPHP o tienen dudas de su funcionamiento los invito a leer la sección sobre el manejo de vistas en KumbiapHP. A continuación el código completo del template y más abajo con capturas se explica cada parte importante.

Archivo: app/views/_shared/templates/pdf/mpdf.phtml

<?php

use Mpdf\Mpdf;

/* Defaults */

// fileName
$fileName = $filename ?? "Reporte-de-$controller_name";

// Title
$title = $title ?? "Reporte de $controller_name";

// CSS
$css = $css ?? 'css/pdf.css';

// Destination I show in browser  D download
$destination = isset($download) && $download ? 'D' : 'I';

//Activa el almacenamiento en búfer de la salida
ob_start();

?>
<!DOCTYPE html>
<html lang="en">

<head>
    <title><?= $title ?></title>
    <link rel="stylesheet" type="text/css" href="<?= $css ?>">
    <meta name="author" content="KumbiaPHP framework">
    <meta name="description" content="PDF output example with KumbiaPHP framework">
    <meta name="keywords" content="kumbiaphp, php, pdf, mpdf, examples">

<body>
    <htmlpageheader name="myHeader1">
        <section id="page-header">
            <a href="https://www.kumbiaphp.com"><img src="img/kumbiaphp.svg" alt="Logo KumbiaPHP"></a>
            <p>Powered by</p>
        </section>
    </htmlpageheader>

    <?php View::content() ?>

    <htmlpagefooter name="myFooter1">
        <section id="page-footer">
            <div id="printed-date">{DATE d/m/Y}</div>
            <div id="page-number">{PAGENO}/{nbpg}</div>
        </section>
    </htmlpagefooter>
</body>

</html>
<?php
$html = ob_get_clean();
ob_clean();

// Crea una instancia de la clase y le pasa el directorio temporal
$mpdf = new Mpdf([
    'tempDir' => APP_PATH . 'temp/mpdf',
    'format' => 'A4',
    'title2annots' => true,  // convert headers <hx> in annotations
    'mirrorMargins' => 0,    // mirror the left and right margin values on odd and even pages 
    'exposeVersion' => false // security 
    // more variables in https://mpdf.github.io/reference/mpdf-variables/overview.html
]);

// Escribe el contenido HTML (Template + View):
$mpdf->WriteHTML($html);

// Genera el PDF, ya sea para su descarga o visualización en el navegador
$mpdf->Output("$fileName.pdf", $destination);

El proyecto ya usa el autoload de composer para tener disponible mPDF y simplemente importa Mpdf\Mpdf. Luego se definen algunas variables para personalizar el PDF y se ejecuta la función ob_start(). «Esta función activará el almacenamiento en búfer de la salida. Mientras dicho almacenamiento esté activo, no se enviará ninguna salida desde el script (aparte de cabeceras); en su lugar la salida se almacenará en un búfer interno.»

Si desean conocer como agregar encabezados y pies de páginas con mPDF un compañero realizó un manual en la Wiki de KumbiaPHP que muestra como agregarlos usando las funciones explicadas en el artículo anterior: Exportar a PDF con cabecera y pie de pagina

Ahora en el <body> definimos el contenido de la cabecera y el pie de página, y entre ellos la función View::content() que nos permite mostrar el contenido de la vista.

Contenido del Body

mPDF maneja sus propias etiquetas, van entre llaves {} y usamos algunas de ellas:

  • DATE: Para mostrar la fecha actual
  • PAGENO: Número de la página
  • nbpg: Número total de páginas del documento

Y la parte final del template es la que se encarga de unir el template con la vista, generar el PDF con ese contenido y hacer que el documento se visualice o descargue.

General el PDF con el contenido HTML

Controlador PHP

Vamos a crear una nueva vista y para ello empezamos con el método que llamaremos pdf() en el controlador templates_examples_controller.php El código se encuentra explicado entre líneas.

Archivo: app/controllers/templates_examples_controller.php

public function pdf()
{
    //Usa el tempalte 'pdf'
    View::template('pdf/mpdf');
    //Modifica el nombre del archivo a descargar
    $this->fileName = 'user-list';
    //Modifica el título del documento PDF en la cabecera
    $this->title = 'User List';
    $this->download = false;

    $this->data = User::all(); // data to show (model User from db)
}

Vista HTML

Ahora crearemos la vista la cual tendrá la tabla, recorriendo uno a uno los registro de la consulta realizada por el modelo en el controlador.

Archivo: app/views/templates_examples/pdf.phtml 

<?php if (!count($data)) : ?>
    <h2>No hay ningún registro</h2> 
<?php else : ?>
    <table class="report">
    <caption class="caption"><?= $title ?></caption>
        <thead>
            <tr>
                <th scope="col">First Name</th>
                <th scope="col">Last Name</th>
                <th scope="col">Email</th>
                <th scope="col">Birthdate</th>
            </tr>
        </thead>
        <tbody> 
            <?php foreach ($data as $item) : ?>
                <tr>
                    <td><?= $item->first_name ?></td>
                    <td><?= $item->last_name ?></td>
                    <td><?= $item->email ?></td>
                    <td><?= $item->birthdate ?></td>
                </tr>
            <?php endforeach ?>
        </tbody>
    </table>
<?php endif ?>

No hace falta explicar mucho más de la vista anterior ya que es una vista normal en KumbiaPHP, esta vista es reutilizable por ejemplo si se quiere pasar a un documento Excel o devolver la vista mediante AJAX.

Enlazar al reporte PDF

Y en donde queramos que esté el enlace al reporte PDF simplemente lo añadimos a la vista deseada, nosotros lo hemos añadio a la página de información de los ejemplos de template.

Archivo: app/views/templates_examples/info.pdf.phtml

<a href="/templates-examples/pdf" target="_blank">Export users list</a>

Y al pulsar el botón visualizaremos el documento PDF como el siguiente:

Visualización del PDF generado con HTML

Descargar código completo

Como siempre, el código completo está disponible para todos en el siguiente repositorio en Github listo para usar: https://github.com/KumbiaPHP/Sandbox/

La entrada Exportar tabla HTML a PDF se publicó primero en KumbiaPHP Framework PHP en español.

]]> https://kumbiaphp.com/blog/2019/04/29/exportar-tabla-html-a-pdf/feed/ 0 2078 Crear PDF usando HTML https://kumbiaphp.com/blog/2018/08/06/crear-pdf-usando-html/?utm_source=rss&utm_medium=rss&utm_campaign=crear-pdf-usando-html https://kumbiaphp.com/blog/2018/08/06/crear-pdf-usando-html/#comments Mon, 06 Aug 2018 10:00:37 +0000 https://www.kumbiaphp.com/blog/?p=1915 Para crear PDF usando HTML con PHP existen diferentes librerías que nos pueden ayudar a cumplir el objetivo de…

La entrada Crear PDF usando HTML se publicó primero en KumbiaPHP Framework PHP en español.

]]> Para crear PDF usando HTML con PHP existen diferentes librerías que nos pueden ayudar a cumplir el objetivo de manera sencilla, esta vez vamos a probar mPDF. mPDF es una librería en PHP la cual permite generar archivos PDF usando HTML(Codificado con UTF-8). Está basada en FPDF y HTML2FPDF, con varias mejoras, fue escrito por Ian Back y lanzado bajo licencia GNU GPL v2.

Instalación de mPDF

El método de instalación oficial de mPDF en PHP es via composer y este es el paquete packagist: mpdf/mpdf.

composer require mpdf/mpdf

Cargando la librería

Como es un ejemplo básico realizaremos la carga de la librería sólo en el controlador que vamos a usar. De la siguiente manera:

Archivo: default/app/controllers/index_controller.php

<?php

// Require composer autoload
require_once APP_PATH . '../../vendor/autoload.php';

use Mpdf\Mpdf;

/** 
 *
 * Controller por defecto si no se usa el routes 
 *
 */
class IndexController extends AppController
{
    public function index()
    {
    }
}

Primer ejemplo de crear PDF usando HTML

Creamos el método example1() donde sin usar vista o template creamos el «Hola mundo» del uso de la librería con el siguiente código:

Archivo: default/app/controllers/index_controller.php

public function example1()
{
    //Importante: Sin vista y sin tamplate 
    View::select(null, null);
    //Crea una instancia de la clase y le pasa el directorio default/app/temp/ 
    $mpdf = new Mpdf(['tempDir' => APP_PATH . '/temp']);
    //Escribe algo de contenido HTML: 
    $mpdf->WriteHTML('¡Hola KumbiaPHP!');
    //Envía un archivo PDF directamente al navegador $mpdf->Output(); 
}

Dependiendo de la configuración del navegador nos mostrará en su visualizador de PDFs el documento creado. En caso contrario nos mostrará el diálogo para iniciar la descarga.

Ejemplo de crear PDF con HTML
Ejemplo de crear PDF con HTML

Segundo ejemplo ¡Usaremos vistas!

El primer ejemplo está bien, pero a nosotros nos gusta darle más orden y para mantener la lógica en su lugar. Vamos a crear un modelo llamado HtmlToPdf (Pueden llamarlo como deseen) y es donde a partir de ahora vamos a crear los archivos PDF, pero esta vez llamaremos el contenido de un partial, el cual nos servirá para mantener separado el HTML del PHP. Primero observemos el contenido del partial:

Archivo: default/app/views/_shared/partials/pdf/example2.phtml

<h1>¡Hola KumbiaPHP!</h1>

Ahora si el método example2() en el modelo:

Archivo: default/app/models/html_to_pdf.php

<?php 
use Mpdf\Mpdf; 

class HtmlToPdf 
{ 
    public static function example2() 
    { 
        // Activa el almacenamiento en búfer de la salida 
        ob_start(); 
        // Carga el contenido del partial 
        View::partial('pdf/example2'); 
        // Obtiene en $html el contenido del búfer actual y elimina el búfer de salida actual 
        $html = ob_get_clean(); 
        // Crea una instancia de la clase y le pasa el directorio temporal 
        $mpdf = new Mpdf(['tempDir' => APP_PATH . '/temp']); 
        // Escribe algo de contenido HTML: 
        $mpdf->WriteHTML($html); 
        // Envia un archivo PDF directamente al navegador 
        $mpdf->Output(); 
    } 
}

Ahora simplemente en el controlador sin usar vista ni template llamaremos el método example2() de la clase modelo HtmlToPdf

Archivo: default/app/controllers/index_controller.php

public function example2() 
{ 
    //Importante: Sin vista y sin tamplate 
    View::select(null, null); 
    //Llama al ejemplo 2 
    HtmlToPdf::example2(); 
}

El código anterior hace exactamente lo mismo que el primer ejemplo, la diferencia es que esta vez usamos MVC. En el modelo añadimos la lógica para crear el documento pdf a partir de una vista parcial (partial), usamos el controlador para llamar el método implementado en el modelo.

Podemos añadir todo el HTML que deseemos siempre y cuando sea compatible con mPDF, eso nos da juego para añadir tablas, imágenes, enlaces, añadir estilos con css, etc.

Ejemplo 3

Vamos a hacer esta vez que el método del modelo reciba un parámetro $name y se lo pase a la vista parcial (partial) pdf/example3.

public static function example3($name) 
{ 
    // Activa el almacenamiento en búfer de la salida 
    ob_start(); 
    // Carga el contenido del partial pasandole datos 
    View::partial('pdf/example3', '', ['name' => $name, 'date' => date(DATE_ISO8601)]); 
    // Obtiene en $html el contenido del búfer actual y elimina el búfer de salida actual $
    html = ob_get_clean(); 
    // Crea una instancia de la clase y le pasa el directorio temporal 
    $mpdf = new Mpdf(['tempDir' => APP_PATH . '/temp']); 
    // Escribe algo de contenido HTML: 
    $mpdf->WriteHTML($html); 
    // Obliga la descarga del PDF y se personaliza el nombre 
    $mpdf->Output('example3.pdf', \Mpdf\Output\Destination::DOWNLOAD); 
}

Ahora haremos que el partial reciba el valor de las variables y las imprima para que se muestre en el PDF.

Archivo: default/app/views/_shared/partials/pdf/example3.phtml

<h1>¡Hola <?= $name ?>!</h1>
<p> Este documento fue generado el <?= $date ?> </p>

Si entramos a la URL: http://localhost:8184/index/example3/Henry nos descargará el PDF con el nombre example3.pdf y veremos algo como la siguiente captura de pantalla:

Ejemplo 3 De HTML a PDF
Ejemplo 3 De HTML a PDF

Estos fueron tres ejemplos básicos para generar PDF usando HTML con PHP.

Segunda Parte de HTML a PDF

Exportar tabla HTML a PDF

Si desean que hagamos un nuevo tutorial con ejemplos avanzados y de la vida real dejen su comentario en la caja de abajo.

Descargar código completo

Como siempre, el código completo del ejemplo para crea documentos PDF con PHP está disponible para todos en el siguiente repositorio en Github listo para usar con Docker: https://github.com/henrystivens/kumbiaphp-mpdf

Nuevos ejemplos de mPDF

Puedes ver un ejemplo del PDF generado más completo funcionando en ejemplo mPDF  y el código PHP de ejemplo controlador y template para usar con cualquier vista de HTML.

La entrada Crear PDF usando HTML se publicó primero en KumbiaPHP Framework PHP en español.

]]> https://kumbiaphp.com/blog/2018/08/06/crear-pdf-usando-html/feed/ 9 1915