Composer 安装 mpdf/mpdf 时默认拉取 v6.1，通常因本地 PHP 版本或扩展不满足 mPDF 7+ 的最低要求所致；通过显式声明 PHP 版本与必需扩展（如 ext-gd、ext-mbstring），可引导 Composer 解析并安装兼容的高版本。
composer 安装 `mpdf/mpdf` 时默认拉取 v6.1，通常因本地 php 版本或扩展不满足 mpdf 7+ 的最低要求所致；通过显式声明 php 版本与必需扩展（如 `ext-gd`、`ext-mbstring`），可引导 composer 解析并安装兼容的高版本。
mPDF 7.x 起已放弃对 PHP 7.2 及更早版本的支持，且强制依赖 ext-gd（图像处理）和 ext-mbstring（多字节字符串支持）。若你使用 XAMPP v3.3.0（默认集成 PHP 7.4 或 8.0），但未在 composer.json 中明确约束环境，Composer 会基于当前 PHP 实际版本及已启用扩展，回退选择兼容性更强的旧版（如 v6.1）——这正是你遇到问题的根本原因。
✅ 解决方法：主动声明运行环境约束
在项目根目录的 composer.json 中添加或更新 require 字段，明确指定目标 PHP 版本与关键扩展：
{
"require": {
"php": "^7.4 || ^8.0 || ^8.1 || ^8.2",
"ext-gd": "*",
"ext-mbstring": "*",
"mpdf/mpdf": "^8.2"
}
}
? 提示：
Discussion Composer下载围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
^7.4 || ^8.0 || ^8.2表示支持 PHP 7.4 至 8.2 的任意小版本，兼顾兼容性与安全性；mpdf/mpdf: "^8.2"显式指定安装最新稳定版（截至 2024 年，v8.x 是主流，v7 已停止维护）；- 扩展名
ext-gd和ext-mbstring必须全小写，且无空格，否则 Composer 无法识别。
执行以下命令更新依赖：
composer update # 或首次安装时直接运行（确保 composer.json 已修改） composer install
⚠️ 验证前提条件（Windows + XAMPP）
请确认你的 XAMPP 中 PHP 已启用所需扩展：
- 打开
xampp/php/php.ini； - 确保以下行未被注释（即前面无分号
;）：extension=gd extension=mbstring
- 重启 Apache 后，运行
php -m | findstr -i "gd mbstring"验证扩展已加载。
? 补充说明
- 若仍安装失败，请运行
composer why-not mpdf/mpdf:^8.2查看具体冲突项（如某依赖锁定了旧版symfony/polyfill-*）； - 不建议强行
--ignore-platform-reqs，它会绕过环境检查，可能导致运行时报错； - mPDF v6.1 已于 2021 年终止维护，升级至 v8.x 不仅获得新特性（如 WebP 支持、CSS Grid 初步兼容），还持续获得安全修复。
遵循上述配置后，Composer 将正确解析并安装 mPDF 8.x（当前推荐版本），彻底告别自动降级至 v6.1 的问题。
