marphi/PdfBundle

This bundle integrates Symfony2 with PHPPdf library.

PsPdfBundle

This bundle integrates Symfony2 with PHPPdf library.

Documentation of PHPPdf you can find on github (README file).

Installation

1. Add this bundle and PHPPdf library to /vendor directory:

    git submodule add git://github.com/psliwa/PdfBundle.git vendor/bundles/Ps/PdfBundle
    git submodule add git://github.com/psliwa/PHPPdf.git vendor/PHPPdf
   

2. Register bundle and PHPPdf library in autoloader:

    //app/autoload.php
    $loader->registerNamespaces(array(
        'Ps' => __DIR__.'/../vendor/bundles',
        'PHPPdf' => __DIR__.'/../vendor/PHPPdf/lib',
    ));
   
    $loader->registerPrefixes(array(
        'Zend_' => __DIR__.'/../vendor/PHPPdf/lib/vendor',
    ));
   

3. Register bundle in AppKernel:

    //app/AppKernel.php
    public function registerBundles()
    {
        return array(
            // ..
            new Ps\PdfBundle\PsPdfBundle(),
            // ..
        );
    }
   

Configuration

All options are optional.

# app/config/config.yml
ps_pdf:
    fonts_file: ~
    enhancements_file: ~
    use_cache_in_stylesheet: ~
    cache:
      type: ~
      options: ~
    markdown_stylesheet_filepath: ~
    markdown_document_template_filepath: ~
    document_parser_type: ~

• fonts_file - path to file with fonts definitions, internal fonts.xml file from PHPPdf library is used by default
• enhancements_file - path to file with complex attributes (enhancements) definitions, internal enhancements.xml file from PHPPdf library is used by default
• cache.type - type of cache, supported are all backend cache from Zend_Cache component (for instance File, Apc, Memcached, Sqlite etc.). File engine is used by default.
• cache.options - specyfic options for cache engine (for instance "cache_dir" for File engine). cache_dir by default is as same as kernel.cache_dir.
• use_cache_in_stylesheet - stylesheet maching rules will be cache, if this option is set. In complex stylesheet cache significantly improves performance. Default is true, but in dev environment cache should be off.
• markdown_stylesheet_filepath - filepath of stylesheet for markdown parser
• markdown_document_template_filepath - xml document template form output of markdown parser
• document_parser_type - default parser type: xml or markdown

Images in source document

If you want to display image, you must provide absolute path to image file via "src" attribute of image tag. Asset Twig function dosn't work, because it converts image path to relative path according to web directory. To make using of images easier, bundle provides Twig function, that converts image logical name to real, absolute path.

Example:

<pdf>
    <dynamic-page>
        <!-- pdf_image('BundleName:image-name.extension') -->
        <img src="{{ pdf_image('SymfonyWebConfiguratorBundle:blue-arrow.png') }}" />
    </dynamic-page>
</pdf>

Example

// In controller
//...
use Ps\PdfBundle\Annotation\Pdf;
//...

/**
 * @Pdf()
 */
public function helloAction($name)
{
    $format = $this->get('request')->get('_format');
    
    return $this->render(sprintf('SomeBundle:SomeController:helloAction.%s.twig', $format), array(
        'name' => $name,
    ));
}

// in helloAction.html.twig
Hello {{ name }}!

// in helloAction.pdf.twig
<pdf>
    <dynamic-page>
        Hello {{ name }}!
    </dynamic-page>
</pdf>

Bundle automatically detects pdf format (via _format) request and create pdf document from response.

Pdf annotation has three optional properties:

• headers - associative array of specyfic headers
• stylesheet - pdf stylesheet template file in standard Symfony2 notation ("Bundle:Controller:file.format.engine")
• documentParserType - type of parser: xml or markdown