Convertir PHP en PDF

Une copie à mise en page fixe est nécessaire lorsqu’une page générée par PHP doit être imprimée, envoyée, partagée ou archivée. Le code source PHP doit soit être exécuté pour produire la page, soit être mis en forme comme du code ; il n’est pas directement converti en PDF final par un convertisseur de fichiers classique.

Ce qu’est le format PHP

PHP est un langage de script côté serveur utilisé par les développeurs et les administrateurs web pour générer des pages dynamiques, des formulaires, des factures, des rapports et des réponses d’API. Un fichier .php contient du code source, généralement mélangé à du HTML, du CSS, du SQL ou du balisage de modèles ; PHP est un langage de programmation et non un format de document.

Un serveur web compatible avec PHP interprète le fichier et renvoie le résultat généré, normalement du HTML, à un navigateur. Ouvrir un fichier .php depuis un gestionnaire de fichiers n’exécute pas son code côté serveur : le texte source peut s’afficher ou le chargement peut échouer, selon le système d’exploitation et l’application.

Ce qu’est le format PDF

PDF est un format de document à mise en page fixe qui préserve les dimensions des pages, les polices, les images, l’espacement et la pagination sur les différents systèmes d’exploitation et appareils. Les destinataires peuvent l’imprimer ou le consulter sans PHP, serveur web ni application ayant créé la page originale.

PDF convient aux factures, aux soumissions officielles, aux pièces jointes d’e-mail et aux copies d’archivage. Il n’est normalement pas destiné à être modifié comme un fichier de traitement de texte, et la conversion ne garantit pas une taille de fichier inférieure ; les polices et les images incorporées peuvent augmenter sa taille.

Convertir la page PHP générée

Utilisez cette méthode lorsque le PDF requis est un rapport, un reçu, un formulaire ou toute autre page produite par le script.

1. Installez PHP et, si nécessaire, un package de serveur local tel que XAMPP, Laragon ou MAMP. Le serveur intégré de PHP suffit pour de nombreux projets autonomes.
2. Placez le projet dans son répertoire de documents et configurez les bases de données, variables d’environnement, extensions, fichiers inclus et dossiers accessibles en écriture requis.
3. Depuis le répertoire approprié du projet ou la racine des documents, exécutez php -S localhost:8000. Cette commande démarre un serveur de développement ; il ne s’agit pas d’un déploiement de production.
4. Ouvrez l’adresse appropriée, telle que http://localhost:8000/report.php, dans Chrome, Edge ou Firefox et vérifiez que la page contient les données attendues.
5. Utilisez Print → Save as PDF dans le navigateur. Sélectionnez le format de papier et les marges requis, activez les graphiques d’arrière-plan lorsque la conception les utilise, puis vérifiez les sauts de page, les images, les en-têtes et les pieds de page dans l’aperçu avant impression.

Pour obtenir de manière répétable un résultat côté serveur, utilisez un workflow Chromium sans interface graphique avec Playwright ou Puppeteer et sa fonction PDF. Fournissez le même CSS d’impression, la même fenêtre d’affichage, le même format de papier, les mêmes marges et les mêmes conditions de chargement de page qu’en production ; attendez la fin des requêtes réseau et le rendu du contenu généré par JavaScript avant de créer le PDF.

Si la page est déjà disponible au format HTML, des services en ligne réputés tels que PDFCrowd ou CloudConvert peuvent effectuer une conversion HTML vers PDF. Importez le HTML généré plutôt que le fichier .php original : ces services n’exécutent généralement pas de PHP arbitraire, et les feuilles de style externes, polices, images, sessions et données authentifiées peuvent ne pas être accessibles.

Convertir le code source PHP

Utilisez cette méthode lorsque le code source lui-même constitue le document, par exemple pour une revue de code, un support de formation ou une trace papier.

1. Ouvrez le fichier dans un éditeur de code tel que PhpStorm, Notepad++ ou Visual Studio Code et activez la coloration syntaxique PHP.
2. Définissez une police monospace lisible, des marges adaptées, le retour à la ligne et, éventuellement, les numéros de ligne. Désactivez le retour à la ligne si la conservation exacte des lignes sources est plus importante que l’adaptation du code à la page.
3. Imprimez depuis un éditeur prenant en charge l’impression, tel que Notepad++ ou PhpStorm, et choisissez une imprimante PDF système : Microsoft Print to PDF sous Windows ou Save as PDF dans la boîte de dialogue d’impression de macOS. Visual Studio Code peut nécessiter une extension d’impression ou une exportation HTML intermédiaire.

Pour automatiser la création de PDF à partir du code source, appliquez la coloration syntaxique avec Pygments ou un formateur similaire, exportez le résultat au format HTML, puis imprimez ce HTML avec Chromium. Cette méthode documente le texte source ; elle n’exécute pas PHP et ne capture pas la page générée par le script.

Générer des PDF dans une application PHP

Pour les factures, rapports ou formulaires récurrents, une application PHP peut créer des PDF à partir de modèles avec des bibliothèques telles que Dompdf, mPDF ou TCPDF. Il s’agit d’une génération de PDF plutôt que d’une conversion de fichier, ce qui nécessite du code, l’installation de dépendances, la préparation de modèles et des tests de la prise en charge du CSS.

Limites liées à la qualité et à la sécurité

L’authentification, les résultats de base de données, les extensions PHP manquantes, les autorisations, les chemins relatifs, le CSS externe, les polices web, JavaScript et le CSS d’impression du navigateur peuvent modifier le résultat rendu. Effectuez des tests avec des données représentatives, vérifiez les images et les sauts de page, puis comparez le PDF à la page accessible à l’URL prévue.

Ne téléversez pas de code source PHP confidentiel, d’identifiants, de données client ou de pages générées privées vers un convertisseur en ligne. Un navigateur local, un processus Chromium sans interface graphique ou une bibliothèque PHP de génération de PDF évite d’exposer ces fichiers et permet d’accéder aux dépendances locales. Supprimez les secrets des PDF contenant du code source et vérifiez que les PDF générés ne contiennent pas de métadonnées indésirables ni de données de formulaire masquées.