composer check-platform-reqs才是决定composer install能否成功的关键命令，它读取composer.json中require和config.platform声明，逐项比对当前PHP环境的版本与扩展是否满足；而composer diagnose仅验证Composer自身启动依赖（如curl、openssl等），完全不检查项目所需的ext-gd或php: "^8.3"等约束。
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）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “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。
