PHP项目上线部署慢？利用Composer中文镜像来优化！-composer-PHP中文网

Composer镜像配置不生效的主因是命令错误：键名必须为repo.packagist（单数）、type值必填composer、URL末尾须带/，三者缺一即静默回退至packagist.org；验证需同时满足config输出标准JSON及install -vvv日志显示镜像路径。

php项目上线部署慢？利用composer中文镜像来优化！

不是网络差，是根本没走镜像——90% 的“部署慢”问题，都卡在 composer config 命令写错三个地方。

为什么 `composer config -g repo.packagist` 总是不生效？

命令看似跑成功了，但 composer install 依然卡在 Downloading from https://packagist.org，本质是配置静默失败：Composer 不报错、不提示，直接 fallback 到默认源。

repo.packagist 写成 repos.packagist（多一个 s）→ 键名非法，完全忽略
漏掉中间的 composer 类型值 → 命令变成 composer config -g repo.packagist https://mirrors.aliyun.com/composer/，Composer 2.x 会当作无效配置丢弃
URL 少了末尾斜杠 / → 拼出 https://mirrors.aliyun.com/composer//p2/monolog/monolog.json 这类路径，返回 404，请求直接失败

验证是否真写进去了：composer config -g repo.packagist 必须输出完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或只返回字符串，说明没配进去。

项目级配置比全局更可靠，尤其在 CI/CD 中

全局配置（-g）在 Docker 容器、宝塔面板、GitLab Runner 等场景下极易失效：基础镜像可能没初始化 ~/.config/composer/ 目录；执行用户（如 www）读不到 root 的配置。

进项目根目录，运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）
该命令自动向 composer.json 的 repositories 字段追加 "packagist" 条目，不覆盖已有私有源
拉代码即生效，CI 构建时无需额外 setup，行为确定

别手动编辑 composer.json：JSON 格式错一个逗号，composer install 就直接报错退出。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

换源后仍卡在 `Resolving dependencies` 或报 `hash does not match`？

镜像只加速下载，不解决依赖解析卡顿，也不兼容旧缓存。

Resolving dependencies 卡住 → 和镜像无关，典型原因是 composer.json 里写了过宽的 PHP 版本约束（如 "php": "^7.4 || ^8.0 || ^8.1 || ^8.2"），或 "minimum-stability": "dev" 导致候选版本爆炸
hash does not match → 旧 composer.lock 记录的是 packagist.org 的包哈希，和镜像返回的元数据不一致，必须删掉 vendor/ 和 composer.lock 重来
换源后第一遍务必加 --no-cache：composer install --no-cache --no-dev --prefer-dist --optimize-autoloader --no-interaction

不清理缓存，Composer 会优先读旧元数据并尝试从 packagist.org 校验，结果就是卡在 DNS 或 TLS 握手——你根本看不到镜像域名出现在日志里。

怎么确认请求真打到了镜像？别信 `config` 输出

composer config -g repo.packagist 显示 URL 正确，不代表网络请求就走了它。必须实测日志：

运行：composer show monolog/monolog -vvv 2>&1 | grep "Downloading"
日志里必须出现 mirrors.aliyun.com 或 mirrors.cloud.tencent.com 等镜像域名
如果看到 https://packagist.org 或 repo.packagist.org，说明 fallback 触发了，配置没起作用

腾讯云镜像（https://mirrors.cloud.tencent.com/composer/）目前最稳，HTTPS + 全量同步 + 无认证要求；阿里云镜像（https://mirrors.aliyun.com/composer/）响应快，适合通用场景；华为云镜像（https://repo.huaweicloud.com/repository/php/）在华南节点表现突出——选哪个，建议用 curl -o /dev/null -s -w "%{time_total}\n" https://xxx/packages.json 实测对比。