PHP项目使用Dompdf时阿拉伯语/波斯语不支持显示为问号如何解决？

该问题通常由编码不匹配、未兼容复杂脚本的字体、未开启特殊排版支持三类原因导致，可按以下步骤逐一排查修复：

1. 确认全链路UTF-8编码配置 #

• 输出给Dompdf的HTML必须在head区域明确声明编码，添加以下标签：

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

• 所有相关PHP源代码文件需保存为UTF-8无BOM格式，避免编码转换过程中字符丢失。

2. 引入支持阿拉伯语/波斯语的字体 #

Dompdf默认自带字体不支持阿拉伯语、波斯语这类包含连字、从右到左排版的复杂脚本，需要自行引入兼容字体：

• 优先选择字符集完整的字体，比如Noto Naskh Arabic、Tahoma、XB Zar等
• 在HTML的样式中通过@font-face规则引入字体，示例代码如下：

@font-face {
    font-family: 'ArabicFont';
    src: url('本地字体文件路径/NotoNaskhArabic-Regular.ttf') format('truetype');
    font-weight: normal;
    font-style: normal;
}
* {
    font-family: 'ArabicFont', sans-serif;
}

• 注意字体文件路径需使用Dompdf可读取的本地绝对/相对路径，不要使用远程URL。

3. 开启Dompdf复杂脚本渲染配置 #

Dompdf默认关闭了RTL（从右到左）、连字等复杂排版特性，初始化时需要显式开启对应配置：

$options = new \Dompdf\Options();
// 开启HTML5解析和UTF-8支持
$options->set('isHtml5ParserEnabled', true);
// 开启字体子集化，减小最终PDF体积
$options->set('isFontSubsettingEnabled', true);
// 配置默认字体为你引入的兼容字体
$options->set('defaultFont', 'ArabicFont');

$dompdf = new \Dompdf\Dompdf($options);
$dompdf->loadHtml($你的HTML内容变量);
$dompdf->render();

额外排查项 #

• 配置修改后如果仍显示问号，先删除Dompdf的字体缓存文件（默认存放在vendor/dompdf/dompdf/lib/fonts目录下，后缀为.ufm的文件），重新运行程序生成新缓存
• 确认你使用的字体本身包含阿拉伯语/波斯语字符集，不要使用仅支持中文/英文的精简字体包
• 如果需要正确的RTL排版，可在对应内容的HTML标签上添加dir="rtl"属性

内容的提问来源于stack exchange，提问作者e-razagh