在PHP 7.4运行mPDF时遭遇Composer版本兼容问题

核心原因 #

你安装的最新版mPDF虽然自身标注支持PHP7.3+，但它的第三方依赖库已经升级到要求PHP8.0，导致Composer触发版本检查报错。

具体解决方向 #

1. 安装兼容PHP7.4的mPDF特定版本 #

不要安装最新版，选择最后一个明确支持PHP7.4的mPDF版本（比如8.1.x系列，这是官方确认兼容PHP7.4的最后一个大版本分支）。执行以下命令：

composer require mpdf/mpdf:^8.1

安装完成后，Composer会自动拉取该版本对应的、兼容PHP7.4的依赖库，不会再触发版本报错。

2. 临时绕过Composer平台检查（应急方案） #

如果必须使用最新版mPDF，可强制Composer忽略PHP版本限制，但需注意可能存在运行时风险：

• 安装/更新依赖时添加参数：

composer install --ignore-platform-reqs
# 或者更新时用
composer update --ignore-platform-reqs

• 或者在项目根目录的composer.json中添加配置，让Composer模拟当前PHP版本：

{
  "config": {
    "platform": {
      "php": "7.4.33" // 替换成你服务器实际的PHP7.4小版本号
    }
  }
}

添加后执行composer update，Composer会按照你指定的PHP版本拉取兼容依赖。

3. 定位并降级冲突依赖 #

如果想保留mPDF最新版，可先找出哪个依赖要求PHP8.0，再单独降级该依赖：

• 执行命令查看所有依赖的PHP版本要求：

composer show -p

• 找到输出中标记php >=8.0.0的包，然后在composer.json中指定该包的兼容PHP7.4的版本，例如：

{
  "require": {
    "mpdf/mpdf": "^8.2",
    "symfony/polyfill-mbstring": "^1.26" // 示例：替换成实际兼容的版本号
  }
}

之后执行composer update即可。

内容的提问来源于stack exchange，提问作者Mike Barbaro