Dompdf 中正确显示阿拉伯语(RTL)文本的完整解决方案

梦伟吖_7962

梦伟吖_7962

2026-11-18

649人浏览

原创

Dompdf 中正确显示阿拉伯语(RTL)文本的完整解决方案

本文详解如何在 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 文档。

WPS零基础入门到精通全套教程!
WPS零基础入门到精通全套教程!

全网最新最细最实用WPS零基础入门到精通全套教程!带你真正掌握WPS办公! 内含Excel基础操作、函数设计、数据透视表等

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

13104

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

7501

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2275

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4748

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

5454

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

4291

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

6237

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4902

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12602

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习