Installation

composer require atelier/text

Requirements

Composer installs the last two. The PHP version and mbstring are yours to provide.

WOFF2 needs a Brotli decoder

WOFF2 files are Brotli-compressed, and PHP has no decoder in its standard build. alto/font accepts either of two:

pecl install brotli        # the extension
brew install brotli        # the command-line binary

The extension is faster because it decodes in process. The binary works everywhere and needs no compilation, which is usually what a container has.

TrueType and OpenType files need neither: they are not compressed.

Verify the installation

use Atelier\Text\SvgText;

$path = SvgText::fromFile('Inter-Regular.woff2')->path('Hi', size: 48);

var_dump($path->isEmpty());   // false
echo substr($path->d(), 0, 40);

Path data printed means the font parsed, the codepoints resolved, and the outlines came back. An empty path means the text produced no glyphs.

A MissingGlyphException at this point means the font has no glyph for one of your codepoints, which is a font problem rather than an installation one. See Errors.

Next: Getting started.