composer diagnose 通过 ≠ 环境配置就对了。它只验证 Composer 自身能否“站稳”，不校验你的项目能不能装、能不能跑。很多团队在 CI 上看到全绿输出后直接 deploy，结果 php vendor/autoload.php 就 fatal error——问题早就在 diagnose 的盲区里了。
composer diagnose 实际检查哪些 PHP 扩展和版本
它会强制检查以下扩展是否已加载且可用：json、phar、filter、hash、mbstring、openssl、zlib（注意：不查 curl 或 zip，但 install 过程中缺它们会直接崩）。PHP 版本仅比对 Composer 自身要求（如 Composer 2.5+ 要求 ≥ 8.1），完全不读取 composer.json 中的 "php": "^8.2" 约束。
- 若提示
The "openssl" extension is missing，别只改 php.ini，还要确认php -m | grep openssl真有输出 - Windows 用户常见问题：php.ini 路径对，但
extension_dir指向了 x64 目录，而实际是 x86 PHP ——php --ini和php -i | grep extension_dir必须一致 - 容器环境里用
php:8.2-cli镜像？默认不带openssl，得显式docker run --rm php:8.2-cli php -m | grep openssl验证
为什么 diagnose 显示 OK，但 composer install 卡在 “Loading composer repositories”
因为 composer diagnose 只测基础 HTTPS 连通性（比如能连通 packagist.org），不验证 CA 证书链是否可信、不检查 GitHub API 限流、不访问你配置的私有仓库。最常踩的坑是：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
Checking https connectivity to packagist.org: OK→ 但实际走的是镜像源，而镜像地址写错了（比如https://mirrors.aliyun.com/composer少了末尾/），diagnose 不校验 URL 格式 -
Checking github.com rate limit: OK→ 但返回头里X-RateLimit-Remaining: 0，说明 token 已过期或没配，diagnose 把它当“能通”就过了 - 用了自定义
repositories，但auth.json里对应域名的 token 缺失或拼写错误 —— diagnose 根本不读这个配置段 - 企业内网禁用了 SNI，导致 HTTPS 握手失败，但 diagnose 的 cURL 请求可能因超时被静默跳过，只显示
Skipped而非FAIL
vendor 目录权限报 OK，但 install 后 autoload 失败怎么办
composer diagnose 只检查 vendor/ 是否可写，不检查里面文件是否存在、是否被 chmod 误删、autoload 映射路径下 PHP 文件语法是否合法。典型脱节场景：
-
vendor/autoload.php文件存在，但内容是空的或含 parse error ——php -l vendor/autoload.php才暴露问题 -
composer.json里写了"psr-4": {"App\": "src/"}，但src/目录根本不存在或权限为 000 —— diagnose 完全不扫这些路径 - Docker 构建时用 root 写了 vendor，运行时切到 www-data 用户，
is_writable('vendor')返回 true（Linux 下 owner 可写），但实际 require 时 open_basedir 或 selinux 拦截了 —— diagnose 无感知 - CI 环境里
composer install --no-dev后，require-dev里的类仍被测试代码引用，autoload 不报错但运行时报Class not found—— diagnose 不管 require-dev
真正要确认环境“对不对”，不能只信 composer diagnose 的绿色 OK。它是个守门员，不是裁判员。关键动作得手动补上：composer validate --strict --check-lock、composer check-platform-reqs、php -l composer.json、php -l vendor/autoload.php —— 这些才是决定项目能不能落地的硬检查。
