Building PHP Documents with CakePdf - CakeFest 2012

BUILDING PHP DOCUMENTS
WITH CAKEPDF
CakeFest Manchester, 2012

ABOUT ME

• Jelle Henkens

• LemonBE on IRC, @lemonit on Twitter

• Belgian in the UK

• Lead Developer at Geneo Software

• CakePHP Core Team Developer

• Founder of followmy.tv

WHAT IS CAKEPDF

• Generate PDF documents from HTML

• Easily pick which library to render the PDF

• PDF Encryption

• Layouts, views, helpers and more

• Use your own encryption / render engine

WHY IT WAS BUILT
• Massive differences in API between pdf libraries
// Using DomPdf // Tcpdf example

require_once("dompdf_config.inc.php"); require_once('config/lang/eng.php');
require_once('tcpdf.php');
$html =
'<html><body>'. $html =
'Put your html here.'. '<html><body>'.
'</body></html>'; 'Put your html here.'.
'</body></html>';
$dompdf = new DOMPDF();
$dompdf->set_paper('A4', 'landscape'); $tcpdf = new TCPDF('portrait', 'mm',
$dompdf-> 'A4');
$dompdf->load_html($html); $tcpdf->AddPage();
$dompdf->render(); $tcpdf->writeHTML($html);
$pdfData = $dompdf->output(); $pdfData = $tcpdf->Output('', 'S');

WHY IT WAS BUILT
• And now with CakePdf
// Using DomPdf // Tcpdf example

App::uses('CakePdf', 'CakePdf.Pdf'); App::uses('CakePdf', 'CakePdf.Pdf');

$html = $html =
'<html><body>'. '<html><body>'.
'Put your html here.'. 'Put your html here.'.
'</body></html>'; '</body></html>';

$cakePdf = new CakePdf(array( $cakePdf = new CakePdf(array(
'engine' => 'CakePdf.DomPdf', 'engine' => 'CakePdf.Tcpdf',
'orientation' => 'portrait', 'orientation' => 'portrait',
'pageSize' => 'A4' 'pageSize' => 'A4'
)); ));

$pdfData = $cakePdf->output($html); $pdfData = $cakePdf->output($html);

BUILT IN RENDER ENGINES
External Binary
WkHtmlToPdf stable
Uses WebKit

DomPdf alpha PHP Based

Mpdf alpha Very Nice!
PHP Based

Tcpdf alpha PHP Based

CONFIGURATION
Setup
Add in Conﬁg/bootstrap.php

CakePlugin::load('CakePdf', array(
'bootstrap' => true,
'routes' => true
));

Needs RequestHandlerComponent

class AppController extends Controller {
public $components = array('RequestHandler');
}

CONFIGURATION
Special case for CakePHP 2.1.x
Conﬁg/bootstrap.php

CakePlugin::load('CakePdf', array(
'bootstrap' => true
));

Conﬁg/routes.php

Router::parseExtensions('pdf');

CONFIGURATION
Settings
Global settings
// Config/bootstrap.php
Configure::write('CakePdf', array(
'engine' => 'CakePdf.WkHtmlToPdf',
'pageSize' => 'A4',
'orientation' => 'portrait'
));

Inside the controller
public function view($id) {
$this->pdfConfig = array(
'orientation' => 'landscape',
'download' => true,
'filename' => 'invoice-2005.pdf'
);
.. Rest of action logic ..
}

TO VIEW OR NOT TO VIEW

• Generating PDF files with the .pdf extension in the URL
• Viewing PDF documents in the browser
• Download to disk
• Smaller files
• Stand-alone to generate raw PDF data
• Email attachments
• Offline processing
• Larger files

REQUESTHANDLER FLOW
View in browser or download to disk

• Layout ﬁle App/View/Layout/pdf/default.ctp
• View ﬁle App/View/Orders/pdf/invoice.ctp
• All the CakePHP goodies to your disposal
• Helpers
• Blocks
• Elements

STAND-ALONE FLOW
App::uses('CakePdf', 'CakePdf.Pdf');

$CakePdf = new CakePdf(array(
'engine' => 'CakePdf.Tcpdf',
'pageSize' => 'A5',
'margin' => 10
));

$html = '
<html><head></head>
<body>CakeFest is the best</body>
</html>';

$rawPdfData = $CakePdf->output($html);

ENCRYPTING PDF FILES

• Protect against viewing, printing, editing and more

• pdftk binary from PDFLabs

• 128 bit encryption

• Second pass encryption

• Encrypt existing PDF documents

PASSWORD TYPES
• Owner password

• Unlock protected permissions

• Cannot be the same as the user password

• User password

• Will prompt before opening the PDF Document

• Cannot exist without an owner password

CRYPTO CONFIGURATION

Add in Conﬁg/bootstrap.php

//Default configuration
Configure::write('CakePdf', array(
'engine' => 'CakePdf.WkHtmlToPdf',
'crypto' => 'CakePdf.Pdftk'
));

USING ENCRYPTING
//Action configuration
public function view($id) {
$this->pdfConfig = array(
'protect' => true,
'userPassword' => 'foo',
'ownerPassword' => 'bar',
'permissions' => array(
'print'
)
);
.. Rest of action logic ..
}

http://github.com/ceeram/CakePdf

THANKS

Jelle Henkens - @lemonit - jelle.henkens@gmail.com

Building PHP Documents with CakePdf - CakeFest 2012

Recommended

Recommended

More Related Content

Recently uploaded

Recently uploaded (20)

Featured

Featured (20)

Building PHP Documents with CakePdf - CakeFest 2012