PHP7.4.7下使用PDFlib加载OTF字体失败求助

我之前在使用PDFlib加载OTF字体时也碰到过一模一样的错误，给你几个实用的排查方向，应该能帮你解决问题：

• 严格匹配字体文件名
  PDFlib查找字体是严格匹配文件名的，尤其是Linux系统下区分大小写。你要确认字体文件的实际名称（比如My-Font-Regular.otf）和你传入load_font的第一个参数完全一致，不能有大小写错误、多余空格或者拼写偏差。

• 验证路径与文件权限
  虽然日志显示SearchPath添加成功，但还是要手动确认：

  1. 目标路径fullpath/to/my/fonts确实存在，可以用var_dump(is_dir('fullpath/to/my/fonts'));验证；
  2. 字体文件My-Font-Regular.otf在该路径下，用var_dump(file_exists('fullpath/to/my/fonts/My-Font-Regular.otf'));检查；
  3. PHP运行进程（比如www-data用户）有读取这个文件的权限，权限不足也会导致“找不到字体”的错误。

• 直接传入字体完整路径测试
  先跳过SearchPath配置，直接把字体文件的完整路径传给load_font，代码如下：

  $font = $pdflib->load_font("fullpath/to/my/fonts/My-Font-Regular.otf", "unicode", "embedding");
  

  如果这样能成功，说明问题出在SearchPath的配置上；如果还是失败，那大概率是字体文件本身的兼容性问题或者PDFlib版本不支持。

• 关于编码参数的注意点
  你尝试的utf-8并不是load_font支持的编码参数，PDFlib里正确的Unicode编码参数就是unicode，所以不用改这个。另外stringformat=utf8是设置PDFlib接收的字符串输入格式，这个设置没问题，但和字体找不到的问题无关。

• 开启详细日志定位问题
  可以给PDFlib开启详细日志，获取更多字体查找的细节：

  $pdflib->set_option('logfilename=pdflib_debug.log');
  $pdflib->set_option('loglevel=3'); // 3级日志会包含资源查找的详细过程
  

  查看生成的日志文件，能清楚看到PDFlib尝试查找哪些路径、哪些字体文件，帮你快速定位问题根源。

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