如何在PHP GD库中启用字体连字功能

结论先行 #

原生PHP GD库提供的imagettftext和imagettfbbox函数默认不支持直接渲染OpenType字体连字效果，GD底层依赖的libfreetype库虽然本身支持连字特性，但GD扩展没有对外暴露对应的配置接口，无法直接开启连字开关。

可行实现方案 #

方案1：基于GD库的折衷实现 #

如果必须保留GD库作为渲染底层，可以用字符预替换的方式实现：

• 确认你使用的字体支持连字且将常用连字映射到了Unicode私有区（PUA），例如Fira Code、JetBrains Mono等常用编程字体都提供了这类映射规则
• 渲染前先将文本中的连字字符组合（例如->、==、===等）替换为字体中对应连字的PUA编码
• 替换完成后再调用imagettftext渲染，用imagettfbbox计算文本宽高即可正常显示连字效果

方案2：更换渲染库实现完美支持 #

如果需要支持任意OpenType标准连字，不需要提前做字符映射，建议更换为ImageMagick扩展实现：

• ImageMagick底层直接支持配置freetype的OpenType特性开关，可以直接开启liga（标准连字）、clig（上下文连字）等特性
• 参考实现代码：

// 初始化Imagick对象
$im = new Imagick();
$draw = new ImagickDraw();

// 配置字体、字号
$draw->setFont('/path/to/your/font.ttf');
$draw->setFontSize(24);
$draw->setFillColor('black');

// 开启连字和字距调整特性
$draw->setOption('text:ligatures', 'true');
$draw->setOption('text:kerning', 'true');

// 创建画布并渲染文本
$im->newImage(800, 200, 'white');
$im->annotateImage($draw, 20, 50, 0, 'fi fl -> == === 测试连字文本');

// 输出图片
$im->setImageFormat('png');
header('Content-Type: image/png');
echo $im;

内容的提问来源于stack exchange，提问作者soulless