如何解决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渲染逻辑。正确操作:- 保留
Kalpurush.ttf在storage/fonts/目录下 - 删掉模板里整段自定义@font-face的CSS代码
- 修改body样式,移除DejaVu Sans的fallback配置,避免渲染优先级跳转:
body { font-family: "Kalpurush"; font-size: 14pt; line-height: 1.4; }
- 保留
排查注意事项
- 确认本地放置的Kalpurush字体是完整官方版本,部分裁剪过的字体文件缺少孟加拉语连字的字形映射表,就算开启了复杂排版也会出现字符拆分问题。如果Kalpurush测试异常,可以替换同是孟加拉语标准字体的SolaimanLipi测试渲染效果。
- 确保传入视图的孟加拉语文本没有经过二次转义破坏Unicode结构,不要对原文进行会拆分连续码位的字符串处理。
内容的提问来源于stack exchange,提问作者raihan
相关产品推荐
相关产品推荐

