CPDF_END_TEXT

Syntaxe

Paramètres

Description

Cette fonction permet de terminer une zone de texte dans 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.
• Son rôle principal est de terminer une zone de texte dans un document PDF. Cela signifie qu'après l'appel à cette fonction, aucun texte supplémentaire ne peut être ajouté dans la zone ouverte par cpdf_begin_text ou les appels à cpdf_continue_text.
• Le paramètre $pdf_document est obligatoire car il identifie le document PDF dans lequel la zone de texte doit être clôturée. Sans ce paramètre, la fonction ne saurait pas quel document finaliser, ce qui rendrait l'appel inutile.
• Cette fonction doit toujours être utilisée après un appel à cpdf_begin_text. L'oubli de cpdf_end_text peut entraîner des problèmes de rendu ou des incohérences dans le document PDF, car la zone de texte resterait ouverte.
• cpdf_end_text illustre la logique des anciennes bibliothèques PDF fonctionnant sur le principe de délimitation explicite des blocs, où chaque ouverture (begin_text) doit avoir sa fermeture correspondante. Cela permet de mieux organiser et contrôler le flux du contenu textuel.
• Comme la fonction est obsolète, les bibliothèques modernes comme TCPDF, FPDF ou mPDF gèrent la fin des blocs de texte de façon plus automatique et offrent des options avancées pour le positionnement, le retour à la ligne et l'alignement du texte.
• L'appel à cpdf_end_text contribue à générer un document PDF valide et conforme aux standards du format, car il clôt correctement les objets textuels et prépare le document pour l'insertion d'autres éléments graphiques ou textuels.
• Ne pas utiliser correctement cpdf_end_text peut entraîner un texte mal positionné ou non rendu, car la zone de texte resterait ouverte et interfèrerait avec d'autres instructions. Cela souligne l'importance de respecter l'ordre exact des appels pour garantir un rendu correct avec CLIBPDF.