The Massive Bundle for managing pdf documents

0.4.2 2022-08-02 08:15 UTC

This package is auto-updated.

Last update: 2024-03-30 00:17:24 UTC


Built upon KnpSnappyBundle:


Install the bundle with composer.

composer require massive/pdf-bundle

Add bundle to your symfony kernel.

new Knp\Bundle\SnappyBundle\KnpSnappyBundle(),
new Massive\Bundle\PdfBundle\MassivePdfBundle(),

Install wkhtmltopdf


apt-get install wkhtmltopdf
apt-get install xvfb
echo ‘xvfb-run –server-args=”-screen 0, 1024x768x24″ /usr/bin/wkhtmltopdf $*’ > /usr/bin/
chmod a+x /usr/bin/
ln -s /usr/bin/ /usr/local/bin/wkhtmltopdf
wkhtmltopdf output.pdf


Configure Knp Snappy Bundle**

See KnpSnappyBundle for configuration.


Controller Trait

The controller trait is the easiest way to generate a pdf:


namespace AppBundle\Controller;

use Massive\Bundle\PdfBundle\Controller\RenderPdfTrait;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;

class YourController extends Controller
    use RenderPdfTrait;

    public function pdfAction(Request $request): Response
        return $this->renderPdf(
                'parameter' => 'hello'

Register the route with default _format as pdf:

    <route id="your.pdf" path="/your.{_format}">
        <default key="_controller">AppBundle:Your:pdf</default>
        <default key="_format">pdf</default>

Now you can access the pdf with /your or use /your.html to get a html response (good for development).

Generate Pdf

/** @var \Massive\Bundle\PdfBundle\Pdf\PdfFactory $pdfFactory */
$pdfFactory = $this->get('massive_pdf.pdf_factory'); // get the service or inject it in your services configuration
$pdf = $pdfFactory->create('pdf.html.twig');

Embedding local assets

The local_asset avoids doing a http request by using file:// instead of https:// for performance improvement:

<img src="{{ local_asset('/images/image.jpg') }}" alt="Local Asset">

This will only work when $request->getRequestFormat() will return pdf and not html.

If you want to force using file:// set the second parameter to true:

<img src="{{ local_asset('/images/image.jpg', true) }}" alt="Local Asset">