TCPDF生成PDF时印地语/马拉地语Unicode字符显示异常问题求助

问题根因 #

你遇到的是天城文复合合字渲染异常问题，TCPDF默认没有开启Indic文字的特殊排版逻辑，无法正确处理श्री这类由多个字符拼接组成的合字，会直接拆分输出单个字符。默认自带的freesans字体对天城文合字的支持也不完整，也是问题诱因之一。

解决步骤 #

1. 首先替换支持完整天城文合字的字体，推荐使用「Noto Sans Devanagari」，下载字体文件后放入TCPDF的fonts目录
2. 开启TCPDF的天城文排版规则，手动加载自定义字体
3. 尽量使用MultiCell替代Cell输出文本，Cell方法对复杂文字的排版适配性较差

修改后可运行代码 #

// 引入TCPDF库
require_once('tcpdf.php');

// 初始化PDF实例，保持UTF-8配置不变
$pdf = new TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);

// 关闭页眉页脚
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);

// 添加页面
$pdf->AddPage();

// 关键配置：指定使用天城文排版规则，开启合字整形
$pdf->setScript('Deva');
// 加载自定义的天城文字体，第三个参数对应你放入fonts目录的字体文件名
$devanagari_font = $pdf->addFont('notosansdevanagari', '', 'NotoSansDevanagari-Regular.ttf', true);
$pdf->SetFont($devanagari_font, '', 16);

// 输出标题，改用MultiCell避免合字拆分
$pdf->MultiCell(0, 5, "॥ श्री मल्लिकार्जुन प्रसन्न ॥ ", 0, 'L', 0, 1);

$pdf->MultiCell(10, 5, " ", 0, 'L', 0, 0);
$pdf->MultiCell(130, 5, "नंबर: ".$_POST['id'], 0, 'L', 0, 0);
$pdf->MultiCell(40, 5, "दिनांक: ".$today_date, 0, 'L', 0, 1);
$pdf->MultiCell(180, 5, "श्री__________________________________________________", 0, 'L');

$pdf->MultiCell(180, 5, "मु़._________________________यांनी___________________बद्दल दिले.", 0, 'L');
$pdf->ln(4);

// 用Line方法生成分隔线，替代字符填充的分隔线，避免排版错位
$pdf->Line($pdf->GetX(), $pdf->GetY(), $pdf->GetX()+180, $pdf->GetY());
$pdf->ln(4);

$pdf->MultiCell(10, 5, "क्र ", 0, 'L', 0, 0);
$pdf->MultiCell(50, 5, "देवक्रत्य  ", 0, 'C', 0, 0);
$pdf->MultiCell(120, 5, "रु.    ", 0, 'R', 0, 1);

$pdf->Line($pdf->GetX(), $pdf->GetY(), $pdf->GetX()+180, $pdf->GetY());

注意事项 #

• 确保你使用的TCPDF版本 >= 6.3.0，旧版本不支持天城文的合字整形逻辑
• 所有马拉地语文本需要保存为UTF-8无BOM编码，不要经过GBK、ISO等编码转码
• 字体加载时如果报错，检查字体文件的权限是否正确，文件名是否和代码中一致

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