phil/fonts

phil/fonts lit les métadonnées des fichiers de police : TrueType et OpenType, collections TrueType et OpenType, WOFF et WOFF2. Pour chaque face, il donne la famille et la sous-famille (typographiques d'abord, comme CSS s'y attend), le nom complet et le nom PostScript, la version, le copyright, la marque de commerce, le fabricant et le dessinateur, la description et l'URL de la licence tirées de la table name, la graisse, la largeur et l'inclinaison, les permissions d'incorporation de la table OS/2 (installable, modifiable, aperçu et impression, restreinte, sans sous-ensemble, bitmaps seulement), les axes de variation d'une police variable et les plages de caractères que couvre sa table de caractères. À partir de ces données, il écrit des règles @font-face et tient, pour chaque fichier, une fiche de licence dans un registre qui indique quels fichiers ont changé depuis la dernière vérification de leur licence.

Il s'adresse à toute application PHP qui sert ou incorpore des polices qu'elle n'a pas dessinées : un site qui laisse ses rédacteurs téléverser des polices et doit écrire leur CSS, une chaîne de production PDF ou EPUB qui doit savoir si une police peut être incorporée et réduite à un sous-ensemble, un écran d'administration qui liste chaque police avec sa licence, une étape de construction qui refuse une police dont elle ne connaît pas la licence. phil/paged-media incorpore des polices TrueType dans des documents PDF ; cette bibliothèque permet à une application de les vérifier d'abord.

C'est une simple bibliothèque PHP qui suit les spécifications OpenType 1.9.1, WOFF 1.0 et WOFF 2.0 et dont les seuls prérequis sont ext-mbstring et ext-zlib. WOFF2 compresse ses tables avec Brotli, que PHP ne décode pas seul. Un fichier WOFF2 est donc lu au moyen d'un décompresseur que l'application fournit, Brotli::decompressor(), qui vaut brotli_uncompress() lorsque ext-brotli est chargée. Sans cette extension, les fichiers WOFF, TrueType et OpenType sont lus, et un fichier WOFF2 est refusé avec un message qui le dit. Rien n'est installé avec elle, et rien n'est téléchargé.

La conception est petite : FontFile lit un fichier pour en tirer son Format et ses faces Font ; une Font contient des Names, des EmbeddingPermissions, des valeurs Axis et des plages de caractères ; FontFaceRule écrit du CSS à partir d'une Font ; LicenceRecord et LicenceRegister conservent ce que chaque fichier dit de sa licence. phil/fonts et phil/paged-media ne dépendent pas l'un de l'autre : voyez Permissions d'incorporation pour savoir pourquoi, et dans quel sens ils le feraient.

État

Documentation

Démarrage rapide

composer require phil/fonts

use Phil\Fonts\Css\FontFaceRule;
use Phil\Fonts\FontFile;
use Phil\Fonts\Format;

$file = FontFile::fromFile('/path/to/ExampleSans-Bold.ttf');
$font = $file->face();

echo $font->family();                          // Example Sans
echo $font->weight;                            // 700
echo $font->embedding->usage->value;           // installable
echo $font->licence()->spdx();                 // OFL-1.1

echo FontFaceRule::for($font)
    ->withUrl('/fonts/example-sans-bold.woff2', Format::Woff2)
    ->withUrl('/fonts/example-sans-bold.ttf', Format::TrueType)
    ->toCss();

use Phil\Fonts\Brotli;
use Phil\Fonts\Licence\LicenceRegister;

$kept = LicenceRegister::fromJson(file_get_contents('fonts/licences.json'));
$now = LicenceRegister::scan('fonts', Brotli::decompressor());

foreach ($kept->changedFiles($now) as $file) {
    echo "Check the licence of {$file}\n";
}

file_put_contents('fonts/licences.json', $now->toJson());

Prérequis

PHP 8.5 ou plus récent, ext-mbstring et ext-zlib ; ext-brotli, ou un autre décodeur Brotli, pour WOFF2.

Contribuer

Les contributions sont les bienvenues sur le monodépôt PHIL : lisez le guide de contribution et le code de conduite. Signalez une vulnérabilité en privé, comme l'explique la politique de sécurité, jamais dans un ticket public.

Licence

MIT, © Philippe Gamache, doing business as Le Gnome Archiviste; a Parler Haut Interagir Librement project. Voir LICENSE.