CPDF_OPEN

Syntaxe

Paramètres

Description

Cette fonction permet d'ouvrir un nouveau document en format PDF. Cette fonction est obsolète.

Remarques

• L'extension CLIBPDF initialement proposé à partir du PHP 3 a été progressivement retiré jusqu'à la version 5 du PHP où elle fut remplacé par l'extension PDFLIB, laquelle est utilisé par de nombreux langages de programmations autre que le PHP. Si vous ne pouvez pas installer un extension supplémentaire, vous pouvez utiliser la bibliothèque gratuite et open source entièrement écrit en PHP pure FPDF Library développé par Olivier PLATHEY.
• Obsolescence de la fonction : cpdf_open est marquée comme obsolète, ce qui signifie qu'elle n'est plus recommandée pour les projets modernes. Son utilisation peut poser des problèmes de compatibilité avec les versions récentes de PHP et il est préférable d'utiliser des bibliothèques PDF actuelles comme TCPDF ou FPDF.
• Dépendance à l'extension CLIBPDF : Cette fonction requiert l'extension CLIBPDF. Si l'extension n'est pas installée ou activée, cpdf_open échouera et aucun document PDF ne pourra être créé, ce qui limite la portabilité du code sur différents serveurs PHP.
• Création d'un document PDF : La fonction permet d'ouvrir un nouveau document PDF et d'initialiser les structures internes nécessaires au dessin. Cela constitue la première étape indispensable avant d'appeler des fonctions telles que cpdf_moveto ou cpdf_lineto.
• Paramètre de compression $compression : Ce paramètre permet de définir le type de compression appliqué au PDF. Une compression inadéquate peut affecter la taille du fichier et la qualité des éléments graphiques ou textes inclus.
• Paramètre $filename optionnel : Si un nom de fichier est fourni, le PDF sera enregistré sous ce nom. Sinon, le document reste en mémoire et devra être sauvegardé explicitement par une fonction de sortie ou d'enregistrement. Cela peut impacter la gestion des fichiers temporaires ou la génération dynamique de PDF.
• Paramètre $doc_limits optionnel : Ce paramètre permet de définir les limites du document, telles que la taille ou les marges. Ne pas le configurer correctement peut entraîner des problèmes de mise en page, en particulier si le document contient des graphiques ou des textes dépassant la zone définie.
• Pas de retour explicite pour la réussite : La fonction ne renvoie pas toujours un indicateur clair de succès ou d'échec. Cela oblige le développeur à vérifier manuellement que le document a bien été ouvert avant de poursuivre le dessin ou l'ajout de contenu.
• Compatibilité limitée avec les versions modernes de PHP : cpdf_open est documentée pour PHP 3.0.8 à 5.0.4, et son utilisation sur des versions PHP 7.x ou 8.x n'est pas garantie. Les projets récents devraient envisager de migrer vers des bibliothèques PDF plus actuelles pour éviter les problèmes de compatibilité et de maintenance.