PHP 8.1 二维码中文变方块 imagettftext 字体路径到底错在哪

活动海报上的二维码上线后,扫进去的店名全是方块。服务器 PHP 8.1.27、GD 2.3.3、endroid/qr-code 4.6,本地 Mac 上生成同一张图完全正常。

error_log 里其实有线索,一天几百条 imagettftext(): Could not find/open font in /data/www/qr/Renderer.php on line 88,被调用处的 @ 压掉了。字体路径写的是 './assets/fonts/msyh.ttc',相对当前工作目录。定时任务用 CLI 跑,cwd 是 /data/www,路径拼出来是 /data/www/assets/fonts/msyh.ttc,文件压根不在那儿。

找不到字体时 imagettftext 返回 false,渲染类没判断返回值,流程继续往下走 imagestring。内置字体只有 Latin-1,中文一律画成方框,看着就像乱码。

中间试错花了半天。先怀疑字符集,把 default_charset 从 UTF-8 改成 GBK,方块照旧;又给 fonts 目录 chmod 777,没用;再把 msyh.ttc 换成 simhei.ttf,还是方块。三个方向都不对,因为字体一次都没被读到。

改成绝对路径 __DIR__ . '/../assets/fonts/NotoSansSC-Regular.otf',同时加 is_file 判断直接抛异常,让问题在日志里显形。ttc 里有多套字形,imagettftext 只取第一套,换成单个 otf 更稳。

判断字体有没有真加载,用 imagettfbbox 比等 warning 快,返回全 0 就是没读到。这行检查放进了部署脚本,路径写错会在发版时失败,不用等用户扫码才发现。

验收不看日志,看扫码。iOS 相机、微信、zbarimg 三端各扫 20 张,中文店名全部正确,imagettftext 的返回值打印出来是 true。

$font = __DIR__ . '/../assets/fonts/NotoSansSC-Regular.otf';
if (!is_file($font)) {
    throw new RuntimeException('font missing: ' . $font);
}
$box = imagettfbbox(14, 0, $font, '订单');
var_dump($box[2] - $box[0]);   // 28 左右,0 表示没读到

您可以还会对下面的文章感兴趣:

暂无相关文章