如何为MPDF设置文档默认语言？配置无效问题求助

开发者阿泽

2026-7-9

MPDF无法设置文档/Lang条目问题排查与解决

问题描述

根据MPDF日志显示，它支持当文档语言可用时设置/Lang条目以提升可访问性（@cuongmits，通过/Lang条目设置默认语言 #1418）。但我给HTML添加lang属性后，MPDF并未识别并设置对应的/Lang条目，不符合文档默认语言的可访问性要求。

我尝试了以下代码，但语言仍未成功设置：

$html = '<!DOCTYPE html><html lang="en-CA"><head><title>'.$doc_title.'</title><style>body{font-size: 12px;}h1{font-size: 14px}.red-asterisk{color:#cf1818;margin-left:4px;}.underline{border-bottom:2px solid;}.list-no-style{list-style:none;}ul{padding-top:30px;}ul ul{padding-top:0;}li{padding-top:10px;}</style></head><body>' . $prepared_checklist_html . '</body></html>';

$mpdf = new \Mpdf\Mpdf(
    array(
        /*
        'default_font' => 'arial', */
        'default_font_size' => 12,
        'currentLang' => 'en-CA',
        'default_lang' => 'en-CA',
        'tempDir'           => $new_child_directory,
    )
);

$mpdf->curlTimeout  = 10;
$mpdf->simpleTables = true;
$mpdf->SetCompression( true );
$mpdf->PDFA = true;
$mpdf->PDFAauto = true;
$mpdf->SetDisplayMode( 'fullwidth' );
$mpdf->SetTitle( 'Plan Checklist' );
$mpdf->SetDisplayPreferences('DisplayDocTitle');

解决方法

手动调用SetLanguage方法
在初始化MPDF后、渲染HTML之前，直接调用SetLanguage()方法强制写入PDF的/Lang元数据：
```
$mpdf->SetLanguage('en-CA');
```
这个方法可以绕过HTML属性识别的问题，直接生效。
升级MPDF版本
确认你使用的MPDF版本是否包含#1418的特性修复。如果是旧版本，建议升级到最新稳定版，确保该功能已正常实现。
排查PDFA模式影响
你开启了PDF/A模式，该规范对元数据格式有严格要求。可以先暂时关闭PDFA = true和PDFAauto = true，测试语言设置是否生效。如果生效，再查阅MPDF文档确认PDF/A模式下语言设置的特殊要求。
验证HTML结构
确保<html>标签的lang属性没有被嵌套元素的lang属性覆盖，且属性值符合BCP 47标准（如en-CA格式正确）。