Génération de PDF avec le Zend Framework

• DOCX - Format Office Open XML
• DOC - Format Microsoft® Word DOC
• HTML - Format XHTML 1.0 Transitional
• RTF - Format Rich Text
• PDF - Format Acrobat® Portable Document
• TXD - Format TX Text Control
• TXT - Format ANSI Plain Text

• BMP - Format Bitmap Image
• GIF - Format Graphics Interchange
• JPG - Format Joint Photographic Experts Group
• PNG - Format Portable Network Graphics
• TIFF - Format Tagged Image File
• WMF - Format Windows Meta File

Utilisation de LiveDocx

Création d'un modèle dans Microsoft® Word 2007

Vous pouvez commencer à concevoir le modèle en insérant du texte, des graphiques et des champs de données avec la boîte de dialogue Field affichée ci-dessous.

Charger les modèles avec des données

$phpLiveDocx = new Zend_Service_LiveDocx_MailMerge( 
    array ( 
        'username' => 'yourUsername', 
        'password' => 'yourPassword' 
    ) 
); 
 
$phpLiveDocx->setLocalTemplate('template.docx'); 
 
$phpLiveDocx->assign('software', 'Magic Graphical Compression Suite v1.9'); 
$phpLiveDocx->assign('licensee', 'Henry Smith'); 
$phpLiveDocx->assign('company',  'Megasoft Co-operation'); 
$phpLiveDocx->assign('date',     'January 14, 2009'); 
$phpLiveDocx->assign('time',     '4:30:43 PM CET'); 
$phpLiveDocx->assign('city',     'Bremen'); 
$phpLiveDocx->assign('country',  'Germany'); 
 
$phpLiveDocx->createDocument(); 
 
$document = $phpLiveDocx->retrieveDocument('pdf'); 
 
file_put_contents('document.pdf', $document); 
 
unset($phpLiveDocx);

Dans plusieurs applications, en particulier celles dans lesquelles les fichiers PDF sont utilisés pour des raisons d'archivage, vous devriez fixer les métadonnées du fichier PDF. La méthode setDocumentProperties() doit être déterminée avant createDocument() :

// instanciez LiveDocx 
 
$billConnections = array( 
    array( 
        'connection_number'   => '+11 (0)222 333 441', 
        'connection_duration' => '00:01:01', 
        'fee'                 => '1.15' 
    ), 
    array( 
        'connection_number'   => '+11 (0)222 333 442', 
        'connection_duration' => '00:01:02', 
        'fee'                 => '1.15' 
    ), 
    array( 
        'connection_number'   => '+11 (0)222 333 443', 
        'connection_duration' => '00:01:03', 
        'fee'                 => '1.15' 
    ), 
    array( 
        'connection_number'   => '+11 (0)222 333 444', 
        'connection_duration' => '00:01:04', 
        'fee'                 => '1.15' 
    ) 
); 
 
$phpLiveDocx->assign('connection', $billConnections); 
$phpLiveDocx->setDocumentProperties($documentProperties); 

Le document résultant document.pdf [104 KB] est enregistré sur le disque et peut être ouvert dans votre lecteur PDF favori, tel que le Document Viewer livré avec Ubuntu :

Attribution de données composées à LiveDocx

// instanciez LiveDocx 
 
$billConnections = array( 
    array( 
        'connection_number'   => '+11 (0)222 333 441', 
        'connection_duration' => '00:01:01', 
        'fee'                 => '1.15' 
    ), 
    array( 
        'connection_number'   => '+11 (0)222 333 442', 
        'connection_duration' => '00:01:02', 
        'fee'                 => '1.15' 
    ), 
    array( 
        'connection_number'   => '+11 (0)222 333 443', 
        'connection_duration' => '00:01:03', 
        'fee'                 => '1.15' 
    ), 
    array( 
        'connection_number'   => '+11 (0)222 333 444', 
        'connection_duration' => '00:01:04', 
        'fee'                 => '1.15' 
    ) 
); 
 
$phpLiveDocx->assign('connection', $billConnections); 
 
// générez et récupérez le document

// instanciez LiveDocx 
 
// enregistrez toutes les images matricielles 
// (zoomFactor, format) 
$bitmaps = $phpLiveDocx->getAllBitmaps(100, 'png');

Notez le paramètre zoomFactor. C'est un pourcentage situé entre 10% et 400%. Cette commande est idéale pour générer des imagettes du document créé, par exemple, pour l'afficher dans le navigateur en prévisualisation.

// enregistrez sur le disque 
// (une page par valeur) 
foreach ($bitmaps as $pageNumber => $bitmapData) { 
    $filename = sprintf('documentPage%d.png', $pageNumber); 
    file_put_contents($filename, $bitmapData); 
    printf('Written %d bytes to disk as %s.%s', filesize($filename), $filename, PHP_EOL); 
}

Déployer LiveDocx dans vos propres applications

Tout le code source PHP, incluant les composants LiveDocx, qui est livré avec le Zend Framework est sorti sous la licence Free BSD. Ainsi, vous pouvez déployer, modifier et redistribuer le code source PHP dans des projets selon les termes de cette licence. Le serveur SOAP de LiveDocx est toutefois un logiciel propriétaire. Vous avez trois possibilités pour déployer ce service SOAP dans vos propres applications :

Serveur public gratuit?

Les développeurs choisissent cette approche dans la majorité des applications. Le serveur LiveDocx par défaut qui est référencé dans les composants du Zend Framework est un serveur public gratuit. Il a toutes les opérations et fonctions des serveurs d'hébergement et peut être utilisé gratuitement dans vos propres applications. Tout ce dont vous avez besoin sont un nom d'utilisateur et un mot de passe - pour cela, cliquez ici.

Solution d'hébergement

Si votre application doit créer des milliers de documents par jour, vous devrez payer une modeste cotisation mensuelle pour accéder à votre propre serveur LiveDocx. En association avec des fournisseurs d'hébergement dominants dispersés dans le monde entier, vous pouvez louer un tel serveur d'hébergement de première qualité dans votre région géographique. Cela réduit le temps de latence et, comme votre application est la seule qui fonctionne sur le serveur, cela augmente la performance.

Licence complète

Pour des applications à très haut débit, il est possible d'installer un ou plusieurs serveurs LiveDocx dans vote propre réseau local. Cette approche réduit le temps de latence à un minimum absolu car le serveur LiveDocx est connecté au serveur d'application web par un réseau local gigabit. Les applications typiques pour la licence complète sont les billets d'avion, la création de factures pour les opérateurs de télécommunications et les applications qui traitent des données très sensibles et privées, tels que des rapports médicaux ou financiers.

En savoir plus

Cette article est une première approche de ce que vous pouvez faire avec LiveDocx. Si vous désirez en savoir plus sur cette nouvelle plateforme performante de génération de document, veuillez consulter les ressources suivantes :

LiveDocx dans PHP5

• Blog phpLiveDocx.
• Articles techniques.

Service SOAP LiveDocx

• Blog LiveDocx.
• Référence API.

N'hésitez pas à contacter l'auteur ou vous adresser au support technique dans le forum d'assistance (gratuit) à tout moment.

Notes de bas de page

[1] domPDF, HTML 2 (F)PDF, HTML_ToPDF, mPDF etc.?

[2] Zend_Pdf, PDFlib, FPDF, Cpdf etc.

A propos de l'auteur : Jonathan Maron travaille dans la conception et le développement d'application web depuis 1996. A ce jour, il est spécialisé dans la production de composants de traitement de texte dans une entreprise internationale.

Jonathan préconise le mouvement FOSS et encourage l'utilisation de logiciels Open Source en rejetant la notion de "réinventer la roue", préférant développer avec des frameworks établis.