合同 PDF 在测试环境中文正常,上线后甲方名字全是问号。日志里有一条 Dompdf\Exception: Unable to create the font cache directory,被 catch 之后只打了行 warning,页面照常输出。
第一反应是字体文件没带上去。把 NotoSansSC-Regular.otf 放进 storage/fonts,setDefaultFont 也改成了 NotoSansSC,问号没变。
再看异常。Dompdf 0.8 第一次用某个字体时,要在自己的 lib/fonts 目录下生成 .afm 和 .ufm 缓存文件。容器里的 vendor 目录构建时归 root,php-fpm 以 www 运行,写不进去。找不到缓存就退回内置字体,内置字体没有中文,统统画成问号。
试过 chmod -R 777 vendor/dompdf,能过,但每次重建镜像又变回只读。也试过在 Dockerfile 里 chown,镜像层多了 200MB,升级依赖之后照样失效。
换方案是把字体目录挪出 vendor。setFontDir 和 setFontCache 都指向 /data/dompdf/fonts,chroot 设成项目根目录,容器启动脚本负责 mkdir 和 chown。字体文件通过镜像 COPY 进去,不跟 composer 走。
确认分两步:先在容器里用 www 用户跑一次渲染,看目录下有没有生成缓存文件;再抽五个模板各导一份,用 pdffonts 检查嵌入字体,中文都能列出来,子集 1.2MB。上线一周没再出问号。
$opts = new Options();
$opts->setFontDir('/data/dompdf/fonts');
$opts->setFontCache('/data/dompdf/fonts');
$opts->setChroot('/data/www');
$dompdf = new Dompdf();
$dompdf->setOptions($opts);
$dompdf->loadHtml($html);
$dompdf->render(); 