Composer install 报“Could not fetch https://repo.packagist.org/packages.json”是因国内直连 Packagist TLS 握手超时、DNS 失败或链路干扰所致；应先用 curl 测试连通性，再排查代理、hosts 污染，可临时切国内镜像（如阿里云、清华、华为），注意同步延迟，必要时跳过 SSL 验证（仅调试）或配置私有仓库。
Composer install 时提示 “Could not fetch https://repo.packagist.org/packages.json”
这是最典型的远程仓库不可达表现，本质是 Composer 默认的 Packagist 镜像（https://repo.packagist.org）在国内直连失败。不是你本地网络完全断开，而是 TLS 握手超时、DNS 解析失败或中间链路被干扰。
- 先用
curl -I https://repo.packagist.org/packages.json测试底层连通性，比 Composer 更早暴露问题 - 如果 curl 也卡住或报
Connection timed out，说明是网络层问题，不是 Composer 配置问题 - 别急着换镜像——先确认是否公司代理/防火墙拦截了 HTTPS 请求，或本地 hosts 被污染（检查
/etc/hosts或C:\Windows\System32\drivers\etc\hosts是否有指向错误 IP 的 packagist 条目）
临时切换国内镜像源（阿里云 / 清华 / 华为）
镜像只是缓存，不能解决所有问题，但能绕过部分网络策略。注意：镜像同步有延迟（通常 5–30 分钟），刚发布的新包可能查不到。
- 全局设置（影响所有项目）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 仅当前项目设置：
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/ - 华为镜像地址是
https://mirrors.huaweicloud.com/repository/php/，注意末尾没有/composer路径 - 设完后运行
composer clear-cache，否则旧缓存可能继续报错
跳过 SSL 验证（仅调试用，生产环境禁用）
某些企业内网强制中间人代理，导致证书校验失败，错误信息里常含 SSL certificate problem 或 unable to get local issuer certificate。
git-staged-commit-message
下载
仅从仓库的暂存文件生成 Git 提交消息。当用户要求 Codex 根据暂存更改、缓存差异、Git 索引或已通过 `git add` 添加的文件来编写、起草、创建或建议提交消息时使用；切勿代表用户执行提交操作。
- 临时跳过：
composer config -g secure-http false，再加composer config -g disable-tls true - 更安全的做法是导出代理 CA 证书，配置到 OpenSSL：
composer config -g cafile /path/to/company-ca.crt - 绝对不要在共享项目中提交
secure-http: false到composer.json，这会降低整个团队的安全水位
使用 --repository 指向私有仓库或本地 zip 包
当所有公网路径都失效，又必须完成构建时，可绕过 Packagist，直接指定依赖来源。
- 从 GitHub Release 下载 zip：
"monolog/monolog": "2.10.0"+"repositories": [{"type": "package", "package": {"name": "monolog/monolog", "version": "2.10.0", "dist": {"url": "https://github.com/Seldaek/monolog/releases/download/2.10.0/monolog-2.10.0.zip", "type": "zip"}}}] - 指向内部 Nexus/Artifactory：
composer config repositories.myprivaterepo composer https://nexus.example.com/repository/composer/ - 注意：手动维护
dist.url易出错，且无法自动解析依赖树，仅适合单个紧急补丁
真正难处理的不是“换源”，而是错误信息模糊时如何分层定位：先判别是 DNS、TCP、TLS 还是 HTTP 层失败；再决定该调系统配置、改 Composer 设置，还是协调运维开白名单。很多所谓“网络故障”，最后发现是 PHP 的 openssl.cafile 指向了一个过期证书 bundle。
