composer diagnose 默认检查10项基础配置,但不验证镜像源、auth.json凭据及包下载能力;加-v可查看详细失败原因,手动补全ssl、权限、代理等诊断。
composer diagnose 能快速发现本地 Composer 环境的常见配置问题,但默认只检查基础项,很多实际报错(比如 Could not find package、SSL certificate problem、Permission denied)它压根不报——得配合手动验证才能准确定位。
composer diagnose 检查了哪些项目
它默认运行 10 项检查,包括:composer.json 格式合法性、vendor/ 目录是否存在、openssl 扩展是否启用、curl 是否可用、CA 证书路径是否可读、git 命令是否在 $PATH 中、unzip 是否可用、phar 写入权限、detect_unicode 是否关闭、以及是否能访问 https://repo.packagist.org(仅 HEAD 请求)。
注意:composer diagnose 不验证镜像源配置是否生效,也不检查 auth.json 凭据是否正确,更不会尝试下载包——这些都得你手动补。
怎么让 diagnose 更有用
加 -v 或 --verbose 参数能看到每项检查的具体执行逻辑和失败原因;加 --no-ansi 可避免颜色干扰日志采集;若只想检查某几项,目前没有原生开关,只能靠排除法:先全量跑一次,再结合错误提示单独验证对应环节。