使用PHPWord预览Doc文件问题：乌尔都语/印地语无法正常预览

我之前在处理非拉丁语系（像乌尔都语、印地语这类RTL右到左语言）的Word转HTML再转PDF时，也踩过类似的坑，给你整理几个关键的解决方向，应该能帮到你：

这类语言的显示核心是字体支持和右到左排版属性，PHPWord默认可能没做好这两点：

• 首先，在PHPWord中创建文本/段落时，要指定支持目标语言的字体，比如乌尔都语用Noto Nastaliq Urdu或Jameel Noori Nastaleeq，印地语用Noto Sans Devanagari：

  $section = $phpWord->addSection();
  // 乌尔都语文本示例：指定字体+RTL对齐
  $section->addText(
      'میرا نام محمد جواد ہے',
      ['name' => 'Noto Nastaliq Urdu', 'size' => 14],
      ['alignment' => \PhpOffice\PhpWord\Style\Paragraph::ALIGN_RIGHT, 'dir' => 'rtl']
  );
  

• PHPWord导出HTML时，可能不会自动把dir="rtl"属性写入标签，导出后可以用DOMDocument手动给容器元素补上这个属性，确保排版方向正确：

  $htmlWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'HTML');
  $htmlWriter->save('output.html');
  
  // 手动添加RTL属性
  $dom = new DOMDocument();
  $dom->loadHTMLFile('output.html');
  $body = $dom->getElementsByTagName('body')->item(0);
  $body->setAttribute('dir', 'rtl');
  $dom->saveHTMLFile('output-rtl.html');
  

不同的PDF转换工具（比如dompdf、wkhtmltopdf）需要单独配置，这里举两个常用工具的设置：

• 如果用dompdf：
  1. 把支持目标语言的字体文件（比如NotoNastaliqUrdu-Regular.ttf）放到dompdf的fonts目录，或者在HTML的CSS中直接指定字体路径：

     @font-face {
         font-family: 'Noto Nastaliq Urdu';
         src: url('./fonts/NotoNastaliqUrdu-Regular.ttf') format('truetype');
     }
     body {
         font-family: 'Noto Nastaliq Urdu', sans-serif;
         direction: rtl;
         unicode-bidi: embed;
     }
     

  2. 开启dompdf的RTL支持：

     $dompdf = new Dompdf\Dompdf();
     $dompdf->set_option('isRTLEnabled', true);
     $dompdf->loadHtmlFile('output-rtl.html');
     $dompdf->render();
     

• 如果用wkhtmltopdf：
  1. 确保服务器系统已经安装了目标语言字体（比如在Ubuntu上通过apt install fonts-noto-nastaliq-urdu安装）；
  2. 转换时加上--enable-rtl参数，同时指定编码：

     wkhtmltopdf --enable-rtl --encoding utf-8 output-rtl.html preview.pdf
     

整个流程中编码出错会直接导致字符乱码：

• 你的PHP代码文件要保存为UTF-8无BOM格式；
• Word文件保存时要选择UTF-8编码（如果是手动创建的话）；
• 导出的HTML必须包含<meta charset="UTF-8">标签；
• PDF转换工具要明确指定UTF-8编码处理。

如果还是有问题，可以先做最小测试：

1. 创建只包含1-2句乌尔都语/印地语的简单Word文件；
2. 用PHPWord转成HTML，直接在浏览器打开看是否正常显示；
3. 手动用PDF工具转换这个HTML，看是否正常；
   通过这个方式可以快速定位是PHPWord导出的问题，还是PDF转换工具的问题。

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