m4t1t0/fop-pdf-bundle

Symfony 2 Apache FOP integration

Apache FOP Symfony2 Integration Bundle

This bundle provides integration with Apache FOP (http://xmlgraphics.apache.org/fop/) for Symfony2, _(*1)

Installation and configuration

Get the bundle

Add to your composer.json, _(*2)

{
    "require": {
        "m4t1t0/fop-pdf-bundle": "dev-master"
    }
}

Use composer to download the new requirement, _(*3)

$ php composer.phar update m4t1t0/fop-pdf-bundle

Add FopPdfBundle to your application kernel

``` php <?php, <sub>(*4)</sub>

// app/AppKernel.php public function registerBundles() { return array( // ... new m4t1t0\FopPdfBundle\FopPdfBundle(),
// ... ); }, <sub>(*5)</sub>

## Configure the bundle

If the fop executable is different than /usr/bin/fop you need to configure this in your config.yml file

FopPdfBundle Configuration

fop_pdf: fop: /usr/local/bin/fop, <sub>(*6)</sub>

# Usage

Use the Pdf annotation in your action

``` php
<?php
/**
 * @Route("/download-pdf")
 * @Pdf()   
 */
public function downloadPdfAction()
{        
    return array(
        'name' => 'Rafa',
    );
}

Create the view downloadPdf.fo.twig inside your Resources directory, <sub>(*7)</sub>

{% extends "FopPdfBundle::basea4.fo.twig" %}

{% block content %}
    <fo:block>
        Hello {{ name }}!
    </fo:block>
{% endblock %}

Options

The Pdf annotation suport these options:, <sub>(*8)</sub>

• output: the name of the output file. You can use the PHP strftime function format, more info: http://es1.php.net/manual/en/function.strftime.php If you need more conrol over the output file name, you can use _pdf_output variable in your return, <sub>(*9)</sub>

• template: Indicates the template to render instead the guesser one., <sub>(*10)</sub>

php <?php /** * @Route("/download") * @Pdf() */ public function downloadPdfAction() { return array( 'name' => 'Rafa', '_pdf_output' => 'custom_pdf_output_filename.pdf', ); }, <sub>(*11)</sub>

TODO

• Support PHP templates, at this moment only twig is supported.
• Create a service to render the XSL-FO template instead of annotation.
• Create twig extensions to help the creation of XSL-FO templates.
• Create more base templates.

, <sub>(*12)</sub>