A bundle to facilitate using TCPDF for PDF generation in Symfony2 applications
Clone or download
sampart Merge pull request #55 from SvetlinStaev/master
Added compatibility to Symfony 4.2+
Latest commit 33e5794 Jan 14, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Controller Added the ability to use a different TCPDF-based class. Mar 13, 2012
DependencyInjection
Resources move license Oct 29, 2012
.gitignore Add basic .gitignore file May 25, 2017
README.md Add note about constraining TCPDF version. Jan 10, 2019
WhiteOctoberTCPDFBundle.php changed logic in function boot that all config parameters can be loaded Jan 28, 2018
code-of-conduct.md Add "contributing" section to README, plus code-of-conduct Jul 21, 2017
composer.json Remove erroneous trailing comma in composer.json Oct 3, 2018

README.md

WhiteOctoberTCPDFBundle

This bundle facilitates easy use of the TCPDF PDF generation library in Symfony2 applications.

Installation

Step 1: Setup Bundle and dependencies

composer require whiteoctober/tcpdf-bundle

Version constraining (optional)

By default, this bundle does not constrain the version of TCPDF that composer installs. (An explanation of this unusual decision is here). This means that a composer update could update to a new major version of TCPDF. Since this bundle is only a thin wrapper around TCPDF, you can normally do such an upgrade without issue.

However, if you do wish to constrain the TCPDF version, find out what version you currently have installed with:

composer show tecnickcom/tcpdf

And amend your project's composer.json to add a TCPDF version constraint in the requires section. For example, if TCPDF version 6.2.17 was installed, "tecnickcom/tcpdf": "^6.2.17" will allow anything < 7 when upgrading.

Step 2: Enable the bundle in the kernel

Add the bundle to the registerBundles() method in your kernel:

In Symfony < 4:

// app/AppKernel.php
<?php

public function registerBundles()
{
    $bundles = array(
        // ...
        new WhiteOctober\TCPDFBundle\WhiteOctoberTCPDFBundle(),
    );
}

In Symfony 4:

// config/bundles.php
return [
    // ...
    WhiteOctober\TCPDFBundle\WhiteOctoberTCPDFBundle::class => ['all' => true],
    // ...
];

(This project is not yet configured with Symfony Flex, so this change to config/bundles.php won't be done automatically.)

If you want to do service autowiring, you'll need to add an alias for the service:

# app/config/services.yml (Symfony 3)
# config/services.yaml (Symfony 4)
services:
    # ...

    # the `white_october.tcpdf` service will be injected when a
    # `WhiteOctober\TCPDFBundle\Controller\TCPDFController` type-hint is detected
    WhiteOctober\TCPDFBundle\Controller\TCPDFController: '@white_october.tcpdf'

Using TCPDF

You can obtain the white_october.tcpdf service from the container, and then create a new TCPDF object via the service:

$pdfObj = $container->get("white_october.tcpdf")->create();

From hereon in, you are using a TCPDF object to work with as normal.

Configuration

Configuration values

You can pass parameters to TCPDF like this:

# app/config/config.yml (Symfony < 4)
# config/packages/white_october_tcpdf.yaml (Symfony 4)
white_october_tcpdf:
    tcpdf:
        k_title_magnification: 2

You can see the default parameter values in WhiteOctober\TCPDFBundle\DependencyInjection\Configuration::addTCPDFConfig.

If you want, you can use TCPDF's own defaults instead:

white_october_tcpdf:
    tcpdf:
        k_tcpdf_external_config: false  # the values set by this bundle will be ignored 

Using a custom class

If you want to use your own custom TCPDF-based class, you can use the class parameter in your configuration:

# app/config/config.yml (Symfony < 4)
# config/packages/white_october_tcpdf.yaml (Symfony 4)
white_october_tcpdf:
    class: 'Acme\MyBundle\MyTCPDFClass'

The class must extend from the TCPDF class; an exception will be thrown if this is not the case.

License

This bundle is under the MIT license. See the complete license in the bundle:

Resources/meta/LICENSE

Contributing

We welcome contributions to this project, including pull requests and issues (and discussions on existing issues).

If you'd like to contribute code but aren't sure what, the issues list is a good place to start. If you're a first-time code contributor, you may find Github's guide to forking projects helpful.

All contributors (whether contributing code, involved in issue discussions, or involved in any other way) must abide by our code of conduct.