如何在mPDF中禁用连字/组合变音符号替换功能？

问题说明 #

使用mPDF 8.1.1生成UTF-8编码的PDF时，字体渲染环节默认启用的OpenType连字特性会自动替换特定字符序列：例如ffl/fi/fl/ffi这类序列会被替换为对应的单字合字（如ffl），直接导致邮箱地址、链接这类需要精确匹配字符的内容失效。
之前尝试配置的allow_charset_conversion=false仅控制编码转换逻辑，和字体渲染阶段的字形替换、连字处理完全无关，因此无法解决该问题。 #

可行方案 #

方案1：全局关闭连字特性（最推荐，不影响PDFA合规性） #

实例化mPDF时，通过fontDescriptor配置项显式禁用所有连字相关的OpenType特性，配置代码如下：

$pdf = new Mpdf\Mpdf([
    'PDFA' => true,
    'PDFAauto' => true,
    'allow_charset_conversion' => false,
    // 禁用所有连字特性
    'fontDescriptor' => [
        'liga' => 0, // 关闭标准连字：覆盖fi/fl/ffl/ffi等常见合字替换
        'dlig' => 0, // 关闭自由连字
        'clig' => 0, // 关闭上下文连字
    ]
]);

该配置不会影响普通UTF-8字符的正常渲染，也不会破坏PDFA格式合规性，适合文档中存在大量需要保留原始字符的内容（如邮箱、链接、代码段）的场景。

方案2：仅针对特定内容段关闭连字 #

如果不需要全局关闭连字（比如希望正文保留连字优化的排版效果），仅需要邮箱这类特殊内容不被替换，可以在写入对应内容前临时调整字体特性：

// 写入普通正文，保持默认连字渲染
$pdf->WriteHTML('<p>这是普通正文内容，连字效果正常保留</p>');

// 写入特殊内容前，临时关闭连字
$pdf->SetFont('','','',false,0,'liga=0,dlig=0,clig=0');
$pdf->WriteHTML('<p>联系邮箱：userffl@example.com</p>');

// 写完特殊内容后，切回原字体配置即可恢复连字渲染

方案3：彻底关闭高级字形处理（含组合变音符号合并） #

如果还存在组合变音符号自动合并导致的字符异常，可以直接全局关闭OpenType布局引擎，同时禁用连字、组合变音符号合并等所有高级字形处理逻辑：

$pdf = new Mpdf\Mpdf([
    'PDFA' => true,
    'PDFAauto' => true,
    'allow_charset_conversion' => false,
    'useOTL' => 0, // 完全禁用OpenType布局引擎
    'autoScriptToLang' => false,
    'autoLangToFont' => false,
]);

注意：该方案会彻底关闭复杂语言排版支持，如果文档包含阿拉伯语、泰语、印地语等需要字形重排、组合塑形的语言，会导致这类语言渲染异常，仅在文档仅包含中文、英文等基础语言时使用。

验证方法 #

配置完成后生成PDF，选中其中的邮箱地址复制到文本编辑器，确认复制出的内容和原始传入的字符串完全一致、ffl等字符序列没有被替换为合字，即配置生效。

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