Installer avec Composer · Packagist ↗
Module optionnel · pdftoolkit/pdf-fonts 0.1.7
English | Français
Convertisseurs optionnels de programmes de police vers les objets PDF de PDFToolkit Core.
Le core représente les dictionnaires, les flux, les CID, les largeurs en unités
PDF et les correspondances /ToUnicode décrits par ISO 32000-1. Ce package lit
le format TrueType externe : répertoire sfnt, cmap, glyf, loca, hmtx,
OS/2, name, head, hhea, maxp et post. Il transforme ensuite les
résultats en valeurs PDF explicites. Un projet qui génère ses PDF sans analyser
un fichier de police n’a pas besoin de ce package.
Installation
Le package est disponible sur Packagist. Dans le projet consommateur :
composer require "pdftoolkit/pdf-fonts:^0.1"
Le module utilise le core roukmoute/pdf:^0.2 || ^0.3 || ^0.4 || ^0.5 || ^0.6,
installé automatiquement par Composer. PHP 8.3 ou supérieur sur une plateforme
64 bits et les extensions ctype, iconv et zlib sont requis pour cet ensemble.
Le namespace des convertisseurs est
PDF\Fonts\TrueType ; celui des objets PDF de police est PDF\Document\Fonts.
Le fichier composer.lock du projet consommateur fixe les versions et les
révisions utilisées.
La documentation commune regroupe les objets du core et les modules. La documentation du module polices présente ses guides et sa référence API.
Les mêmes convertisseurs sont compatibles avec le core 0.6. La sélection de la version PDF de sortie et la validation des exigences des fonctionnalités PDF 2.0 appartiennent au writer du core.
Construction
Chaque étape est un objet instancié et peut être manipulée indépendamment. Aucun registre global, singleton ou fabrique statique n’intervient.
use PDF\Document\Fonts\CIDFontType2;
use PDF\Document\Fonts\CIDToGIDMap;
use PDF\Document\Fonts\CIDWidths;
use PDF\Document\Fonts\FontDescriptorFlags;
use PDF\Document\Fonts\FontFile2;
use PDF\Document\Fonts\ToUnicodeCMap;
use PDF\Document\Fonts\Type0Font;
use PDF\Fonts\TrueType\CharacterMapFactory;
use PDF\Fonts\TrueType\CIDFontProgram;
use PDF\Fonts\TrueType\FontDescriptorFactory;
use PDF\Fonts\TrueType\FontProgram;
use PDF\Fonts\TrueType\TextEncoder;
use PDF\Fonts\TrueType\UnicodeText;
use PDF\Syntax\Filters\FlateDecode;
use PDF\Syntax\Object\NumericType;
$program = new FontProgram($fontBytes);
$cidProgram = new CIDFontProgram($program);
$fontFile = new FontFile2($cidProgram->bytes, new FlateDecode());
$repertoire = new UnicodeText('Français : été. Ελληνικά : Αθήνα.');
$map = (new CharacterMapFactory($cidProgram))->create($fontFile, $repertoire);
$descriptor = (new FontDescriptorFactory($cidProgram))->create(
$fontFile,
new FontDescriptorFlags(4),
new NumericType(80),
);
$descendant = new CIDFontType2($descriptor, new CIDToGIDMap($map), new CIDWidths($map));
$font = new Type0Font($descendant, new ToUnicodeCMap($map));
$text = (new TextEncoder($map))->encode($repertoire);
$fontBytes est fourni par l’application. Le package ne reçoit aucun chemin ni
URL et n’effectue aucun accès à un fichier. Le résultat $text est une chaîne
PDF de codes Identity-H de deux octets, destinée à un opérateur de texte.
Le didacticiel de conversion détaille la séparation, les objets et les limites. L’exemple complet produit un PDF avec la police Noto Sans incluse sous licence OFL.
Portée et contrôles
PHP 8.3 ou supérieur sur une plateforme 64 bits est requis. Seuls les programmes
TrueType statiques simples avec contours glyf sont pris en charge. Les
collections, CFF, WOFF et polices variables sont rejetés explicitement. Tous les
glyphes sont conservés : aucune réduction en sous-ensemble, composition
contextuelle, ligature, crénage ni écriture verticale n’est effectuée.
Le budget par défaut est de 32 MiB de données de police ; FontProgramLimits
permet de fournir un budget explicite. UnicodeText est limité à 1 MiB de UTF-8.
Les accès binaires restent bornés à leur table, les références de glyphes et les
cycles/composites sont contrôlés, et les cmap restent sous forme binaire.
Les droits d’incorporation fsType sont vérifiés ; les restrictions et les
polices réservées aux bitmaps sont rejetées.
Les tests conservent les cas de troncature, dépassement d’offset, chevauchement de tables, Unicode invalide, CID/GID invalides, cycles et profondeur des glyphes ainsi que les contre-exemples d’allocation mémoire. Ces contrôles ne constituent pas une garantie d’absence de vulnérabilités pour toutes les entrées possibles.
Développement
Les tests utilisent une fonte synthétique originale sous licence MIT. Le binaire et son générateur sont committés ; Python et fontTools ne sont pas requis pour exécuter les tests PHP.
composer install
composer check
php examples/embedded-font.php embedded-font.pdf
Consulter le changelog et la politique de sécurité.