DomPDF字体缓存问题解析与解决方案

问题背景

在使用DompPDF库进行PDF生成时，开发者可能会遇到一个常见的字体缓存问题。具体表现为当尝试获取文本宽度时，系统抛出"Undefined array key"异常，提示默认字体文件(.afm.json)未被正确缓存。

问题根源分析

这个问题的核心在于DompPDF的字体加载机制。当系统尝试加载默认字体Helvetica时，会按照以下流程工作：

1. 首先检查是否已经加载了指定字体
2. 如果没有，则尝试从字体目录中查找对应的.afm文件
3. 找到后生成并缓存.afm.json文件

问题出现在第二步，因为DompPDF默认使用相对路径"./fonts/Helvetica.afm"来查找字体文件，而实际工作目录可能与预期不符，导致文件查找失败。

技术细节

在CPDF类的实现中，关键代码如下：

if (!isset($this->fonts[$font]) && file_exists("$dir/$metrics_name")) {
    // 加载并缓存字体
}

这里的$dir变量默认指向"./fonts"目录，而实际字体文件可能位于vendor目录下，如"/var/www/project/vendor/dompdf/dompdf/lib/fonts/"。

解决方案

临时解决方案

1. 修改默认字体路径：

$dompdf->getCanvas()->get_cpdf()->defaultFont = '/绝对路径/到/fonts/Helvetica.afm';

2. 更改工作目录：

chdir(__DIR__.'/vendor/dompdf/dompdf/lib');

3. 显式加载字体：

$dompdf->getCanvas()->get_cpdf()->selectFont('/绝对路径/到/fonts/Helvetica.afm');

最佳实践

1. 初始化时设置字体：

$options = new Options();
$options->set('fontDir', '/绝对路径/到/fonts/');
$options->set('fontCache', 'storage/dompdf-font-cache');
$dompdf = new Dompdf($options);

2. 确保渲染流程完整： 在获取文本宽度前，先完成一次完整的文档加载和渲染流程。

注意事项

1. 使用默认字体计算的文本宽度可能与实际显示字体不同
2. 生产环境中建议明确指定所有使用的字体
3. 确保字体缓存目录有写入权限

未来改进

DompPDF开发团队已计划在下一版本中修复此问题，将默认字体路径改为使用__DIR__常量，确保能正确找到字体文件位置。

通过理解这一问题的本质和解决方案，开发者可以更好地在项目中使用DompPDF库，避免类似的字体缓存问题。