
本文详解如何在 dompdf 中实现阿拉伯语从右向左(rtl)排版,包括 css 方向控制、字体配置及关键源码补丁,确保字符顺序、对齐与渲染均符合阿拉伯语阅读习惯。
本文详解如何在 dompdf 中实现阿拉伯语从右向左(rtl)排版,包括 css 方向控制、字体配置及关键源码补丁,确保字符顺序、对齐与渲染均符合阿拉伯语阅读习惯。
Dompdf 原生对阿拉伯语(RTL)支持有限:即使设置了 direction: rtl 和 text-align: right,部分版本仍会将阿拉伯字符按 Unicode 码点顺序逐字渲染,导致视觉上“反向”(如 «سلام» 显示为 «مالس»)。根本原因在于 Dompdf 的文本渲染器未对 RTL 文本执行逻辑顺序重排(logical-to-visual shaping),尤其缺失对阿拉伯语连字(cursive joining)和双向算法(BIDI)的支持。但通过组合三方面优化,可实现可靠显示:
✅ 1. 前端 HTML/CSS 层:声明 RTL 行为
在 HTML 中为阿拉伯内容显式设置方向与对齐:
<style>
.arabic-text {
font-family: 'DejaVu Sans', sans-serif; /* 必须使用支持阿拉伯语的字体 */
direction: rtl;
text-align: right;
unicode-bidi: bidi-override; /* 强制双向行为,增强兼容性 */
}
</style><div class="arabic-text">
مرحبًا بك في تقريرك الشهري — هذا نص عربي كامل.
</div>
⚠️ 注意:
DejaVu Sans是 Dompdf 内置推荐字体,已包含阿拉伯字符集(U+0600–U+06FF 等),无需额外加载.ttf;若使用自定义字体,请确保其包含阿拉伯语字形且已通过load_font.php正确注册。
✅ 2. 后端 PHP 层:启用远程字体与临时目录
你的初始化配置基本正确,但建议补充两项关键设置以提升稳定性:
$dompdf = new Dompdf([ 'logOutputFile' => sys_get_temp_dir() . '/dompdf.log', // 启用日志便于调试 'isRemoteEnabled' => true, 'isHtml5ParserEnabled' => true, // 启用 HTML5 解析器,更好处理 Unicode/RTL 'fontDir' => $tmp . '/fonts', 'fontCache' => $tmp . '/fonts', 'tempDir' => $tmp, 'chroot' => $_SERVER['DOCUMENT_ROOT'] ?? $tmp, // 避免 chroot 过于严格导致资源加载失败 ]);
✅ 3. 核心修复:修补 Dompdf 渲染器(Text.php)
Dompdf ≤ v2.0.x 的 Renderer\Text.php 缺少 RTL 字符重排逻辑。需手动注入 Unicode 字符级反转(适用于无复杂连字的场景,满足大多数阿拉伯语文档需求):
打开文件:vendor/dompdf/dompdf/src/Renderer/Text.php
定位到 render() 方法中调用 $this->_canvas->text(...) 的前一行(通常在约第 140–160 行附近),在其上方插入以下代码:
// --- BEGIN RTL Arabic Fix ---
if (strtolower($style->direction) === 'rtl' && !empty($text)) {
// 按 Unicode 字符(非字节)分割并反转,保持组合字符完整性
preg_match_all('/./us', $text, $matches);
$text = implode('', array_reverse($matches[0]));
}
// --- END RTL Arabic Fix ---
✅ 此补丁作用:对
direction: rtl的文本块,将字符串按 Unicode 码点逆序排列,使مرحبا→ابحرم→ 正确显示为مرحبا(视觉顺序)。它不依赖外部库,轻量且兼容性强。
? 验证示例
完整可运行片段:
require_once 'dompdf/autoload.inc.php';
$tmp = sys_get_temp_dir();
$dompdf = new Dompdf([
'isHtml5ParserEnabled' => true,
'isRemoteEnabled' => true,
'fontDir' => $tmp . '/fonts',
'fontCache' => $tmp . '/fonts',
'tempDir' => $tmp,
]);
$html =
<meta charset="UTF-8"><style>
body { font-family: 'DejaVu Sans', sans-serif; }
.arabic { direction: rtl; text-align: right; }
</style><h1 class="arabic">تقرير الأداء الشهري</h1>
<p class="arabic">تم إنجاز جميع المهام بنجاح. وصل التحديث الجديد في ٢٠٢٤/٠٥/١٥.</p>
HTML;
$dompdf->loadHtml($html);
$dompdf->setPaper('A4', 'portrait');
$dompdf->render();
$dompdf->stream('arabic-report.pdf', ['Attachment' => false]);
? 总结与注意事项
- ✅ 必须使用
DejaVu Sans或其他已注册的阿拉伯语支持字体;默认sans-serif可能回退至无阿拉伯字形的字体。 - ✅
unicode-bidi: bidi-override+direction: rtl是 CSS 层最小可行方案;避免仅用text-align: right。 - ⚠️ 补丁仅解决字符顺序,不支持高级阿拉伯语特性(如上下文敏感连字、数字本地化);如需专业排版,建议升级至 Dompdf v3+(实验性 Harfbuzz 支持)或切换至 TCPDF / mpdf。
- ? 修改
vendor/文件属临时方案;生产环境建议通过 Composer patch plugin(如cweagans/composer-patches)自动化管理补丁。
遵循以上步骤,即可在纯 PHP 环境中稳定输出符合阿拉伯语阅读习惯的 PDF 文档。










