Composer diagnose 命令用于检测环境中的网络、配置和权限问题，重点检查与 Packagist 的 HTTP/HTTPS 连接及 GitHub API 速率限制，帮助快速定位依赖安装失败原因。
当你在使用 Composer 安装或更新 PHP 依赖时遇到超时、连接失败或包无法下载的问题，网络连通性往往是罪魁祸首。Composer 提供了一个实用命令 diagnose，能快速检测你的环境是否能正常访问 Packagist 和相关资源。
Composer diagnose 命令的作用
composer diagnose 会运行一系列检查，帮助你识别潜在的网络、配置或权限问题。它不自动修复错误，但会给出清晰的提示，让你知道哪里出了问题。
执行该命令后，你会看到类似以下输出：
Checking platform settings: OK Checking git settings: OK Checking http connectivity to packagist.org: OK Checking https connectivity to packagist.org: OK Checking github.com rate limit: OK Checking disk free space: OK如果某项检查失败，比如 “http connectivity” 显示失败，就说明你的机器无法正常连接到 Packagist。
如何通过 diagnose 检查网络连通性
打开终端，进入项目目录或任意路径，运行：
composer diagnose重点关注以下几项输出：
- http connectivity to packagist.org：检测是否能通过 HTTP 访问主仓库
- https connectivity to packagist.org：检测 HTTPS 连接（推荐）
- github.com rate limit：检查 GitHub API 调用配额，避免因频繁请求被限流
如果这些连接显示失败，可能是由于：
- 本地网络限制（如公司防火墙）
- 代理未配置
- DNS 解析问题
- 系统 hosts 文件屏蔽了相关域名
常见修复方法
根据 diagnose 的提示，可以采取以下措施：
- 确认网络是否能正常访问外部站点，尝试 ping packagist.org 或用浏览器打开 https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19
- 若在代理环境中，设置 Composer 使用代理：
composer config --global http-proxy http://proxy.example.com:8080 - 临时切换镜像源加速访问，例如使用国内镜像：
composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/ - 检查 php.ini 中是否禁用了 allow_url_fopen 或 cURL 扩展缺失
总结
Composer 的 diagnose 命令是排查网络问题的第一步。它能快速告诉你是否能连上 Packagist，节省盲目调试的时间。遇到安装失败时，先运行 composer diagnose，根据反馈定位是网络、代理还是配置问题，再针对性解决。
基本上就这些，简单却很实用。
