MPDF项目教程：页面尺寸与方向设置详解

前言

在PDF文档生成过程中，页面尺寸和方向的设置是基础但至关重要的环节。本文将深入讲解如何在MPDF项目中灵活控制页面尺寸和方向，帮助开发者创建符合各种业务需求的PDF文档。

一、MPDF支持的页面尺寸

MPDF提供了多种预设的页面尺寸选项，开发者可以直接使用这些标准规格：

1. 国际标准纸张尺寸：A0-A10系列（如A4、A5等）
2. 北美标准尺寸：Letter、Legal、Ledger等
3. 其他常用尺寸：B系列、C系列信封尺寸等

这些预设尺寸可以满足大多数文档需求，开发者无需记忆具体尺寸数值，直接使用名称即可。

二、初始化设置页面尺寸和方向

在创建MPDF实例时，可以通过构造函数参数进行初始设置：

// 使用A4横向页面
$mpdf = new \Mpdf\Mpdf(['format' => 'A4-L']);

// 自定义尺寸（宽190mm，高236mm）
$mpdf = new \Mpdf\Mpdf(['format' => [190, 236]]);

// 仅设置方向为横向（保持默认尺寸）
$mpdf = new \Mpdf\Mpdf(['orientation' => 'L']);

参数说明：

• format：可接受字符串格式的预设尺寸名称，或数组形式的自定义尺寸
• orientation：'P'表示纵向（Portrait），'L'表示横向（Landscape）

三、文档中动态调整页面设置

在实际文档生成过程中，我们经常需要改变页面设置：

1. 使用AddPage方法

$mpdf->AddPage('L'); // 添加横向页面
$mpdf->AddPage('P', 'Legal'); // 添加Legal尺寸的纵向页面

2. 使用HTML标签

<pagebreak orientation="L" format="A5" />

3. 使用CSS @page规则

@page {
    size: A4 landscape;
    margin: 15mm;
}

四、实用技巧与最佳实践

1. 混合使用不同页面设置：可以在文档中交替使用不同尺寸和方向的页面，适合制作包含横向表格和纵向文字的文档。

2. 自定义尺寸注意事项：

   • 尺寸数组格式为[宽度, 高度]，单位为毫米
   • 建议保持合理的宽高比例，避免打印问题

3. 性能考虑：频繁切换页面设置会增加PDF文件大小，应合理规划文档结构。

4. 打印兼容性：使用标准尺寸能确保最佳打印效果，自定义尺寸需测试目标打印机的兼容性。

五、常见问题解答

Q：如何设置首页与其他页不同的尺寸？ A：可以在输出内容前使用AddPage方法添加新页面并指定不同尺寸。

Q：为什么我的自定义尺寸不生效？ A：请检查尺寸数组是否包含两个数值，且单位是否为毫米。某些版本可能有最小/最大尺寸限制。

Q：横向页面会影响页眉页脚吗？ A：页眉页脚会自动适应页面方向，但可能需要调整边距设置以获得最佳效果。

结语

掌握MPDF的页面尺寸和方向设置是生成专业PDF文档的基础。通过本文介绍的方法，开发者可以灵活控制文档布局，满足各种复杂的业务需求。建议在实际项目中多尝试不同的组合，找到最适合特定场景的配置方案。