如何在 Yii2 中正确使用 mPDF 的多列布局功能-php教程-PHP中文网

如何在 Yii2 中正确使用 mPDF 的多列布局功能

本文详细讲解在 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）：

Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板，适合旧项目兼容、升级验证和开发测试。

下载

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('

' . date('Y-m-d H:i:s') . '

Page {PAGENO}

'); // 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 属性（如是无效的 HTML 标签），仅支持 PHP 方法驱动；
表格跨列处理：若 HTML 中含，默认会强制单列显示。如需跨所有列，需添加内联样式：
或使用 colspan 配合 break-inside: avoid;（mPDF v8.0+ 支持部分 CSS fragmentation）；
内存与超时：复杂多列内容易触发内存溢出，建议保留 set_time_limit(300) 和 ini_set('memory_limit', '512M')。
? 总结：在 Yii2 中实现 mPDF 多列，本质是回归原生 mPDF 工作流——放弃 Pdf 组件的便捷封装，换取对渲染生命周期的完全控制。此举虽增加少量代码，却能彻底规避配置冲突与时机错误，是生产环境稳定输出双栏 PDF 的最佳实践。