README

PDF Generator Bundle based on wkhtmltopdf

Requirements

• xvfb to be installed on your server (apt-get install xvfb on debian/ubuntu)

By default this bundle uses the h4cc/wkhtmltopdf-i386 package's binary. To use your system binary, add this to your parameters.yml.dist file and do a composer install

    forci_pdf_generator.binary: wkhtmltopdf

Register the bundle in your AppKernel

<?php
public function registerBundles() {
    $bundles = [
        new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
        // Add ForciPdfGeneratorBundle to your AppKernel
        new \Forci\Bundle\PdfGenerator\ForciPdfGeneratorBundle(),
    ];
}

Basic Usage

<?php 

use \Forci\Bundle\PdfGenerator\Generator\PdfResult;

/** @var \Forci\Bundle\PdfGenerator\Generator\PdfGenerator $generator */
$generator = $container->get('forci_pdf_generator.generator');
$filename = 'someFile.pdf';
$html = 'someHtmlString';
// Get a PdfResult. The wkPrint and bootstrap methods both return a PdfResult
/** @var \Forci\Bundle\PdfGenerator\Generator\PdfResult $result */
$result = $generator->wkPrint($html);
// This will NOT cleanup on KernelEvents::TERMINATE
$result = $generator->wkPrint($html, false);
// The PdfResult is the result of the PDF generation. It has access to the temporary PDF file
$tempPdfPath = $result->realPath();
// return a Symfony BinaryFileResponse
return $generator->bootstrap($html)->response($filename);
// return a BinaryFileResponse, 500 on error
return $manager->wkPrint($html)->response($filename, PdfResult::RESPONSE_ON_ERROR_500_RESPONSE);
// return a Response, 500 on error. This will read the whole file into memory and set it to the newly created Response object
return $manager->wkPrint($html)->response($filename, PdfResult::RESPONSE_ON_ERROR_500_RESPONSE | PdfResult::RESPONSE_TYPE_NORMAL);
// return a Symfony Response and copy the file some place else
// The Generator does NOT save the files; it will unlink them as soon as the request is finished
// The copy() method returns PrintResult
return $generator->bootstrap($html)->copy('/some/location/someFile.pdf')->response($filename);
// And last, you can also get the PDF file contents as string
$contents = $generator->bootstrap($html)->contents();

TODO

• https://www.npmjs.com/package/chrome-headless-render-pdf
• http://weasyprint.readthedocs.io/en/latest/install.html