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 PHP Based

Tcpdf alpha PHP Based

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

Editor's Notes