Composer安装检测运行环境？必备扩展组件预检查-composer-PHP中文网

composer check-platform-reqs才是决定composer install能否成功的关键命令，它读取composer.json中require和config.platform声明，逐项比对当前php环境的版本与扩展是否满足；而composer diagnose仅验证composer自身启动依赖（如curl、openssl等），完全不检查项目所需的ext-gd或php: "^8.3"等约束。

composer安装检测运行环境？必备扩展组件预检查

composer diagnose 不能替代扩展预检查，它只验证 Composer 自身能否启动，不校验项目依赖所需的扩展是否就绪。 真正决定 composer install 能否成功的是 composer check-platform-reqs，它读取 composer.json 中所有 require 和 config.platform 声明，并逐项比对当前 PHP 环境——这才是你该先跑的命令。

为什么 `composer diagnose` 显示 OK 却 `install` 失败

因为 diagnose 只查 Composer 自己要吃的几口饭：PHP 版本 ≥ 8.1、json、mbstring、openssl、phar、filter、hash、curl 或 openssl 扩展是否存在。它完全不管你的项目 require 里写的 "ext-gd": "*" 或 "php": "^8.3"。

常见脱节：diagnose 通过，但 install 报 ext-zip * is required but not installed —— 因为项目用了需要 zip 解压的包，而 diagnose 不管这个
diagnose 不加载 config.platform，所以即使你在 composer.json 里写了 "platform": {"php": "8.2"}，它也当没看见
它不触发任何扩展的实际函数调用（比如 ZipArchive::open()），所以即使 zip 扩展存在但底层缺 libzip，diagnose 仍显示 OK

`composer check-platform-reqs` 才是真实环境快照

这个命令从 Composer 2.2 开始默认启用，会输出当前环境对项目所有平台要求的满足状态。它不联网、不写文件，纯本地比对。

默认只检查 require 中声明的 PHP 版本和扩展，加 --with-dependencies 才递归检查 require-dev 里的包（比如 PHPUnit 依赖的 ext-dom）
输出中出现 ext-gd * missing 就说明 GD 没启用，哪怕 php -m | grep gd 有输出——可能只是扩展加载了但运行时能力异常（如缺少 freetype 库）
若看到 php: 8.1.27 does not satisfy php ^8.2，先检查是不是 config.platform.php 写死了版本，而不是急着升级 PHP

手动筛查扩展是否存在？别只信 `php -m`

php -m 只告诉你扩展模块是否被加载，但 Composer 安装阶段会调用具体函数，失败点往往在更底层。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

Linux/macOS：确认 extension_dir 下真有 mbstring.so、zip.so 等文件，且权限可读
Windows：检查 php.ini 中 extension=php_mbstring.dll 未被注释，且 extension_dir 目录下存在该 DLL
验证 openssl 是否可用：php -r "echo openssl_encrypt('test', 'AES-128-CBC', 'key12345678901234', 0, 'iv12345678901234');"，不报错才算真正可用
Docker 用户注意：docker-php-ext-install zip 必须配合 docker-php-ext-enable zip，只装不启等于没装

CI/部署脚本里怎么写才可靠

别依赖交互式命令，用一行判断关键扩展是否真正就绪：

php -m | grep -E '^(json|mbstring|openssl|curl|zip|xml|gd)$' && composer check-platform-reqs --no-dev || (echo "Platform check failed" && exit 1)

这行脚本做了两件事：先确认基础扩展列表存在，再用 check-platform-reqs 校验项目级要求。加 --no-dev 是为了模拟线上环境，避免 require-dev 干扰判断。如果其中任意一项失败，整个 CI 步骤就中断——比等 install 卡在半路再报错更早发现问题。

最容易被忽略的是：扩展名大小写敏感（gd 不是 GD），check-platform-reqs 的输出不会提示你拼错了扩展名，它只会安静地显示 missing。