CPDF_PAGE_INIT

Syntaxe

Paramètres

Description

Cette fonction permet d'indiquer le début d'une nouvelle page d'un document de 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_page_init 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 conseillé d'utiliser des bibliothèques PDF actuelles comme TCPDF ou FPDF pour gérer les pages.
• Dépendance à l'extension CLIBPDF : Cette fonction nécessite l'extension CLIBPDF. Si l'extension n'est pas installée ou activée, la fonction ne pourra pas initialiser de pages dans le PDF, ce qui limite la portabilité du code entre différents environnements PHP.
• Paramètre $pdf_document obligatoire : L'objet PDF passé en paramètre doit être valide et correctement créé avec cpdf_open. Si ce document n'a pas été ouvert correctement, l'initialisation de la page échouera et aucune modification ne pourra être effectuée sur le document.
• Numérotation de page via $page_number : Le paramètre $page_number permet de spécifier le numéro de la page à créer ou à modifier. Une mauvaise numérotation peut provoquer des erreurs logiques, comme des pages manquantes ou des écrasements de contenu sur des pages existantes.
• Orientation de page via $orientation : L'orientation de la page peut être définie à 0 pour portrait ou 1 pour paysage. Il est crucial de définir correctement ce paramètre avant de dessiner du contenu, sinon le rendu graphique pourrait apparaître déformé ou mal aligné.
• Dimensions de page $height et $width : Ces paramètres définissent la taille de la page en unités choisies. Une mauvaise configuration des dimensions peut entraîner des problèmes de mise en page ou de chevauchement du contenu, surtout lorsque le document contient du texte ou des images de taille fixe.
• Paramètre optionnel $unit : Le paramètre $unit permet de spécifier l'unité de mesure de la page (par exemple, points, millimètres ou pouces). Ne pas préciser l'unité peut générer des incohérences dans la taille et la position des éléments dessinés sur la page.
• Compatibilité limitée avec les versions modernes de PHP : La fonction est documentée pour PHP 3.0.8 à 5.0.4. Son utilisation sur PHP 7.x ou 8.x n'est pas garantie et peut entraîner des comportements inattendus. Pour les projets modernes, il est recommandé de migrer vers des bibliothèques PDF maintenues et compatibles.