本文详细讲解在 Yii2 框架中集成 mPDF 时启用双栏（或多栏）排版的正确方法，解决因调用时机、API 使用方式或配置冲突导致的 SetColumns() 报错问题，并提供可直接运行的完整示例。
本文详细讲解在 yii2 框架中集成 mpdf 时启用双栏（或多栏）排版的正确方法，解决因调用时机、api 使用方式或配置冲突导致的 `setcolumns()` 报错问题，并提供可直接运行的完整示例。
在 Yii2 中使用 mPDF 扩展（如 kartik-v/yii2-mpdf）实现多列布局时，常见错误源于对 mPDF 原生 API 与 Yii2 封装层之间调用逻辑的混淆。核心问题在于：SetColumns() 必须在写入 HTML 内容之前调用，且不能通过 Pdf::methods 数组延迟执行——因为 kartik\mpdf\Pdf 组件会在内部自动调用 WriteHTML()，此时再设置列数已失效，从而触发 mPDF Error: Columns can only be set before writing content 类似报错。
✅ 正确做法是：绕过 Yii2 的 Pdf 封装类，直接实例化原生 Mpdf 对象，并严格遵循「先设列 → 再写内容 → 最后输出」的执行顺序。
以下为推荐的完整实现方案（兼容 Yii2.0+ 及 mPDF v8.x）：
use Mpdf\Mpdf;
// 1. 创建原生 mPDF 实例（注意：使用 Mpdf\Mpdf，非 kartik\mpdf\Pdf）
$mpdf = new Mpdf([
'format' => 'A4',
'orientation' => 'P',
'margin_top' => 40,
'margin_bottom' => 20,
'margin_left' => 15,
'margin_right' => 15,
'cssInline' => '.left { margin-right: 100px; }',
]);
// 2. ✅ 关键：在 WriteHTML 前调用 SetColumns()
// 参数说明：列数、垂直对齐方式（'J'=justify）、列间距（单位：mm）
$mpdf->SetColumns(2, 'J', 5);
// 3. 可选：设置页眉页脚（需在 WriteHTML 前或后，但建议统一管理）
$header = '<div style="text-align:center; font-size:14px; font-weight:bold;">审计报告汇总</div>';
$mpdf->SetHeader($header);
$mpdf->SetFooter('<table width="100%"><tr><td align="left">' . date('Y-m-d H:i:s') . '</td><td align="right">Page {PAGENO}</td></tr></table>');
// 4. 渲染视图生成 HTML（保持原有逻辑）
$htmlContent = $this->renderPartial('resultscore', [
'model' => $model,
'reportyear' => $reportyear,
'questionnairep' => $questionnairep,
'questionnairehuc' => $questionnairehuc,
'questionnairecm' => $questionnairecm,
'regionlist' => $regionlist,
'auditrecord' => $auditrecord,
]);
// 5. ✅ 写入 HTML 内容（必须在 SetColumns 之后）
$mpdf->WriteHTML($htmlContent);
// 6. 输出 PDF（支持下载/浏览器预览/保存文件）
return $mpdf->Output("report_{$reportyear}.pdf", 'D'); // 'D' = 下载；'I' = 内联预览⚠️ 注意事项：
- 禁止混用封装类与原生 API：若使用 kartik\mpdf\Pdf，其 methods 中的 'SetColumns' => [...] 会被忽略或触发错误，因其内部 WriteHTML() 调用不可控；
- CSS 兼容性限制：mPDF 的多列模式不支持 column-count CSS 属性（如 <columns column-count="2"> 是无效的 HTML 标签），仅支持 PHP 方法驱动；
- 表格跨列处理：若 HTML 中含 <table>，默认会强制单列显示。如需跨所有列，需添加内联样式：<table style="page-break-inside: avoid;"> 或使用 colspan 配合 break-inside: avoid;（mPDF v8.0+ 支持部分 CSS fragmentation）；
- 内存与超时：复杂多列内容易触发内存溢出，建议保留 set_time_limit(300) 和 ini_set('memory_limit', '512M')。
? 总结：在 Yii2 中实现 mPDF 多列，本质是回归原生 mPDF 工作流——放弃 Pdf 组件的便捷封装，换取对渲染生命周期的完全控制。此举虽增加少量代码，却能彻底规避配置冲突与时机错误，是生产环境稳定输出双栏 PDF 的最佳实践。
