CPDF_GLOBAL_SET_DOCUMENT_LIMITS

Syntaxe

Paramètres

Description

Cette fonction permet de fixer les limites d'objets 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 fixer des limites globales pour un document PDF, incluant le nombre maximum de pages, de polices de caractères, d'images, d'annotations et d'objets. Cela permet de prévenir des dépassements de capacité lors de la génération de documents volumineux.
• Le paramètre $maxpages indique le nombre maximum de pages autorisées dans le PDF. Cette limitation est utile pour contrôler la taille finale du document et éviter les erreurs lors de l'ajout de nombreuses pages.
• Le paramètre $maxfonts permet de définir le nombre maximum de polices de caractères que le document peut utiliser. Une limitation stricte peut éviter d'augmenter inutilement la taille du fichier, mais elle oblige à gérer avec soin le choix des polices utilisées.
• Le paramètre $maximages fixe le nombre maximum d'images pouvant être insérées dans le PDF. Cela peut être essentiel pour prévenir des dépassements mémoire ou des documents trop lourds lors de l'ajout d'images multiples.
• Le paramètre $maxannotations définit le nombre maximum d'annotations (comme les notes, liens ou commentaires) dans le document. Cela permet de limiter la complexité du PDF et d'assurer sa compatibilité avec certains lecteurs PDF plus anciens ou limités.
• Le paramètre $maxobjects détermine le nombre maximum d'objets PDF que le document peut contenir. Cela inclut toutes les entités internes comme les tracés, textes, images et polices de caractères, garantissant que le document reste structuré et lisible.
• Comme cette fonction est obsolète, les bibliothèques modernes telles que TCPDF, FPDF ou mPDF gèrent automatiquement ces limites ou les optimisent dynamiquement. Son utilisation dans les projets récents n'est plus nécessaire et peut rendre le code difficile à maintenir et incompatible avec PHP actuel.