You need to enable JavaScript to run this app. 如何解决Laravel Dompdf生成PDF时Kalpurush字体孟加拉语显示分离问题
优惠活动
大模型
产品
解决方案
定价
更多

如何解决Laravel Dompdf生成PDF时Kalpurush字体孟加拉语显示分离问题

问题本质

同类文字拆分是孟加拉语场景下使用Dompdf生成PDF的高频共性问题,核心原因是旧版本Dompdf默认渲染引擎不支持复杂文字成形(Complex Text Layout)。孟加拉语属于需要动态字符组合、连字调整的书写系统,必须根据相邻字符的位置调整附加符号的渲染位置,旧版引擎会把每个独立Unicode码位拆分渲染,就算匹配了字体、配置了UTF-8字符集,也会出现原本连贯的আমি被拆为আ ম ি的显示问题。

分步解决方案
  • 升级对应依赖包版本
    首先需要将Laravel-Dompdf包升级到2.0及以上稳定版本,该版本内置了复杂文字排版的核心支持,1.x版本无论怎么调整配置都无法正确渲染孟加拉语组合字符。执行命令更新依赖:
    composer require barryvdh/laravel-dompdf:^2.0
  • 补全Dompdf渲染配置
    现有代码仅配置了dpi和默认字体,缺少字体目录映射、渲染模式的相关开关,修改PDF生成逻辑:
    $pdf = PDF::setOptions([
        'dpi' => 150,
        'defaultFont' => 'Kalpurush',
        'isRemoteEnabled' => true,
        'enable_html5_parser' => true,
        'fontDir' => storage_path('fonts'),
    ])->loadView('text.download', compact('data'));
    
  • 调整字体加载逻辑避免冲突
    目前在Blade模板里通过@font-face加载storage路径字体的方式,会被Dompdf的路径解析逻辑识别为非法web字体路径,反而触发 fallback 到默认字体的无CTL渲染逻辑。正确操作:
    1. 保留Kalpurush.ttf在storage/fonts/目录下
    2. 删掉模板里整段自定义@font-face的CSS代码
    3. 修改body样式,移除DejaVu Sans的fallback配置,避免渲染优先级跳转:
      body {
          font-family: "Kalpurush";
          font-size: 14pt;
          line-height: 1.4;
      }
      
排查注意事项
  • 确认本地放置的Kalpurush字体是完整官方版本,部分裁剪过的字体文件缺少孟加拉语连字的字形映射表,就算开启了复杂排版也会出现字符拆分问题。如果Kalpurush测试异常,可以替换同是孟加拉语标准字体的SolaimanLipi测试渲染效果。
  • 确保传入视图的孟加拉语文本没有经过二次转义破坏Unicode结构,不要对原文进行会拆分连续码位的字符串处理。

内容的提问来源于stack exchange,提问作者raihan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 03:24:04