
本文详细讲解如何在 dompdf 中实现阿拉伯语从右向左(rtl)正确显示,包括 css 方向控制、字体配置、核心源码修复及注意事项,适用于原生 php 环境(非 laravel 专属)。
本文详细讲解如何在 dompdf 中实现阿拉伯语从右向左(rtl)正确显示,包括 css 方向控制、字体配置、核心源码修复及注意事项,适用于原生 php 环境(非 laravel 专属)。
Dompdf 原生对阿拉伯语等双向(BiDi)文字支持有限:它能加载 RTL 字体(如 DejaVu Sans),但默认不执行字符顺序重排(即无法自动将逻辑顺序的阿拉伯文本转为视觉上正确的 RTL 渲染),导致文字“镜像错乱”——看似从左到右排列,实为 Unicode 字符未按 RTL 规则重组。以下为经过验证的端到端解决方案。
✅ 1. 基础 CSS 控制方向与对齐
在 HTML 中显式声明 RTL 上下文,这是前提:
<style>
body {
font-family: 'DejaVu Sans', sans-serif;
unicode-bidi: embed; /* 强制启用双向算法 */
}
.arabic, p[dir="rtl"], div[dir="rtl"] {
direction: rtl;
text-align: right;
/* 可选:解决部分连字断裂问题 */
-webkit-font-feature-settings: "liga", "rlig";
font-feature-settings: "liga", "rlig";
}
</style>
<div class="arabic">مرحباً بالعالم العربي</div>
<p dir="rtl">هذا نص عربي يظهر بشكل صحيح</p>⚠️ 注意:仅
direction: rtl不足以修复字符逆序问题,必须配合后续代码层修正。
✅ 2. 关键修复:修改 Dompdf 文本渲染逻辑
Dompdf 4.x/5.x(主流稳定版)的 Text.php 渲染器未内置 RTL 字符重排。需手动增强其 RTL 处理能力:
定位文件:
vendor/dompdf/dompdf/src/Renderer/Text.php
(⚠️ 若使用旧版 Dompdf 1.x/2.x,路径可能为vendor/dompdf/dompdf/lib/fonts/...或src/Renderer/Text.php;请以实际Text.php中存在$this->_canvas->text(...)调用为准)在
render()方法内,找到调用$this->_canvas->text(...)的前一行(通常位于文本绘制主逻辑末尾),在此行上方插入以下代码:
// --- BEGIN RTL Arabic text fix ---
if (strtolower($style->direction) === 'rtl' && preg_match('/[\x{0600}-\x{06FF}\x{0750}-\x{077F}\x{08A0}-\x{08FF}]/u', $text)) {
// 按 Unicode 字符(而非字节)分割并反转,确保阿拉伯字母、数字、标点正确重排
preg_match_all('/./us', $text, $chars);
$text = implode('', array_reverse($chars[0]));
}
// --- END RTL Arabic text fix ---- 确保该代码块位于
$this->_canvas->text(...)调用之前,例如:
// ... 其他样式计算逻辑
if (strtolower($style->direction) === 'rtl' && preg_match('/[\x{0600}-\x{06FF}\x{0750}-\x{077F}\x{08A0}-\x{08FF}]/u', $text)) {
preg_match_all('/./us', $text, $chars);
$text = implode('', array_reverse($chars[0]));
}
$this->_canvas->text($x, $y, $text, $font, $size, $style->color, $word_spacing, $letter_spacing);✅ 此修复精准识别阿拉伯 Unicode 区段(基本阿拉伯语、阿拉伯补充、阿拉伯扩展-A),仅对含阿拉伯字符的文本执行逆序,避免影响拉丁或数字内容。
✅ 3. 字体与环境配置强化
-
强制使用 DejaVu Sans:该字体完整覆盖阿拉伯语字形且支持 OpenType 连字。确保
<style></style>中全局声明,并确认fontDir目录可写(Dompdf 会自动下载并缓存):$dompdf = new Dompdf([ 'fontDir' => $tmp . '/fonts', 'fontCache' => $tmp . '/fonts', 'tempDir' => $tmp, 'chroot' => $_SERVER['DOCUMENT_ROOT'], // 更安全的 chroot(非 $tmp) 'isRemoteEnabled' => true, // 允许下载 DejaVu 字体 ]); -
禁用字体子集(可选):若出现缺字,可在渲染前添加:
$dompdf->getFontMetrics()->registerFont(['family' => 'DejaVu Sans', 'dir' => $tmp . '/fonts']);
? 总结与注意事项
- ✅ 有效组合:CSS
direction: rtl+text-align: right+unicode-bidi: embed是声明层基础;PHP 层字符逆序是渲染层关键补丁。 - ⚠️ 版本兼容性:本方案适用于 Dompdf ≥ 1.2.0(推荐使用 dompdf/dompdf v2.0+ 或最新稳定版);v2.0+ 已初步支持 BiDi,但仍建议保留上述修复以保障兼容性。
- ? 安全性提醒:修改
vendor/文件属临时方案。生产环境建议通过 Composer patches 或继承TextRenderer类实现无侵入扩展。 - ? 进阶替代:如需完美 BiDi 支持(含阿拉伯连字、数字上下文处理),推荐迁移到 TCPDF 或 mpdf —— 二者原生集成 ICU/BiDi 引擎。
完成以上步骤后,阿拉伯语文本将严格按视觉顺序从右向左流畅呈现,彻底解决“反向显示”问题。


















