PHP 7.2下CI 3.1.3中mpdf 5.7加载pdf报错如何修复？

错误核心根源 #

mpdf5.7原生最高支持PHP5.6版本运行，PHP7.2移除了大量废弃语法、调整了函数参数规则，旧版mpdf的源码调用逻辑无法适配新环境，常见的报错包括类加载失败、函数未定义警告、PDF输出流被中断导致浏览器无法识别文件格式。

分场景修复操作 #

场景1：不升级mpdf大版本（适配存量老项目） #

• 替换mpdf源码中PHP7.2已废弃的函数调用：
  • 全局搜索源码内所有each()遍历逻辑，将原while(list($k,$v) = each($arr))写法，替换为等价的foreach($arr as $k => $v)遍历
  • 全局替换所有create_function()字符串式匿名函数，改写为原生闭包实现
  • 修正所有参数顺序不符合PHP7.2要求的系统函数调用，比如ini_set()、parse_str()这类严格校验参数顺序的接口
• 调整CI框架的mpdf加载逻辑：
  • 不要依赖CI的类自动加载机制扫描mpdf文件，直接在控制器中用绝对路径require_once APPPATH.'libraries/mpdf/mpdf.php'手动引入入口文件，避免类名大小写匹配冲突
  • 实例化mpdf时，去掉所有已废弃的冗余初始化参数，仅保留页面尺寸、边距、自定义字体路径等核心必填配置
• 输出前清理残留内容：
  • 实例化mpdf前加error_reporting(E_ALL & ~E_DEPRECATED & ~E_NOTICE);，屏蔽运行阶段的弃用警告中断输出
  • 调用PDF输出方法前执行ob_clean();清空之前的所有输出缓冲区，避免调试内容、CI框架的默认页面片段混进PDF二进制流

场景2：不改动mpdf源码的快速兼容 #

• 为PHP7.2加装旧函数兼容扩展，全局注册each()、create_function()等已被移除的函数，直接复用现有mpdf源码
• 在PDF对应的路由配置中，关闭display_errors，将所有错误日志写入文件而不是直接输出到响应流，避免警告内容破坏PDF文件格式

场景3：长期稳定运行方案 #

• 将mpdf版本升级到兼容PHP7.2的8.0.x分支，该版本对CI3.x的加载逻辑有原生适配，仅需要将旧版mpdf的自定义字体、页眉页脚配置做少量参数映射，不需要改动核心业务逻辑

常见易忽略的报错原因：CI框架开启的gzip压缩、session自动发送的Cookie头、控制器方法中提前输出的调试内容，都会导致HTTP响应头不符合PDF文件要求，即使mpdf库本身运行正常，也会出现PDF加载失败的问题。

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