Composer中文镜像在Linux服务器中优化部署的步骤-composer-PHP中文网

composer全局镜像未生效主因是配置未被php进程读取或被项目级repositories覆盖：必须用当前执行用户（如www-data）执行带-g的正确命令，键名repo.packagist、type值composer、url以/结尾三者缺一即静默回退官方源。

composer中文镜像在linux服务器中优化部署的步骤

镜像源配对了，composer install 还卡在 Downloading https://packagist.org/packages.json？说明根本没走镜像，不是网络慢，是配置静默失效。

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

这不是命令输错了，而是写到了 PHP 进程看不到的地方，或者被更高优先级覆盖了。

composer config -g 写进的是当前用户（比如 whoami 输出的）的 ~/.composer/config.json；sudo composer config -g 写进的是 /root/.composer/config.json，而 Web 服务（如 www-data）或 CI runner 根本读不到
项目根目录只要存在 composer.json 且含 "repositories" 字段（哪怕空对象 {}），全局配置就立即失效
验证真实生效路径：运行 composer config -g --global-config，它会输出实际读取的文件路径
Alpine 或最小化系统里，~ 可能指向 /root 或 /var/www，得先 ls -la ~/.composer 确认目录是否存在

`composer config -g repo.packagist` 的三要素缺一不可

漏掉任意一个，就静默退回到官方源，连错误都不报，但日志里全是 packagist.org 域名。

Workflow Decomposer

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

下载

-g 参数不能省——没它就是改当前项目 composer.json，换目录就失效
键名必须是 repo.packagist（单数 repo，不是 repos，也不是 packagist.org）
URL 必须是 HTTPS、末尾带斜杠 /，例如 https://mirrors.aliyun.com/composer/；少斜杠会拼成 /composerpackages.json 导致 404
type 值必须显式写 composer，不能省略——Composer 2.0+ 不写这个就会 fallback 到官方源

换源后仍卡在 `Resolving dependencies`？和镜像无关

镜像只加速下载，不解决依赖解析慢的问题。这个阶段卡住，90% 是本地配置或环境问题。

composer.lock 缺失或未提交——Composer 被迫重算整个依赖图，耗时指数级增长
"minimum-stability": "dev" 开启后，Composer 会试探所有 dev 分支版本，每个都超时重试
项目引用了已下线或 DNS 不通的私有仓库，Composer 默认逐个重试 30 秒，总耗时可达几分钟
CLI 模式下 OPcache 被禁用（常见于 Docker 容器未启用 opcache.enable_cli=1），导致 Composer 自身反复编译
快速定位：运行 composer diagnose 看是否提示 Repo packagist.org is default；再执行 composer config --list --global | grep repositories 确认实际生效源

Alpine 和 CI 环境必须额外处理的点

Alpine 极简镜像、Docker 构建、CI 脚本这些场景下，常规配置容易漏掉关键环节。

Alpine 3.16+ 已移除 apk add composer，必须用 curl 安装，且提前装好 git unzip curl，装完立刻删掉：apk del --purge git unzip curl
runtime 阶段若仍保留 .composer 目录或 composer.json，会导致 composer install 误读配置，应只 COPY --from=builder /app/vendor
CI 中以 runner 用户运行，但 -g 配置写在 ubuntu 用户家目录下——得用 sudo -u runner composer config -g ... 或改用项目级配置
parallel-downloads=10 是提速刚需，Composer 2.2+ 默认只有 3，并发不够会拖慢整体安装；设法全局启用：composer config -g parallel-downloads 10

最容易被忽略的其实是权限和路径错位：Web 服务用户读不到 root 的配置，Docker 容器里 $HOME 不等于你预期的路径，composer.json 里一个空 "repositories":{} 就能让所有全局设置作废。别只盯着命令有没有输对，先确认 PHP 进程真正加载的是哪个配置文件。