利用Composer中文镜像显著缩短PHP生产环境的冷部署时间-composer-PHP中文网

镜像只加速下载，不解决依赖解析和自动加载重建慢的问题；卡在“resolving dependencies”需修正composer.json约束、提交lock文件并禁用dev稳定性；配镜像必须满足四条件且清缓存验证。

利用composer中文镜像显著缩短php生产环境的冷部署时间

直接配镜像源本身不缩短冷部署时间——真正卡住的是 composer install 里依赖解析 + 下载 + 自动加载重建这三步。镜像只加速下载，而生产环境慢，八成出在后两步没优化。

为什么镜像配对了，`composer install` 还要 3 分钟？

镜像只管下载包（.zip 或 .tar），不管依赖求解。以下情况会让 composer install 卡在 “Resolving dependencies” 阶段，和镜像无关：

"minimum-stability": "dev" —— 强制拉取开发分支，候选版本爆炸式增长
"php": "^7.4 || ^8.0 || ^8.1 || ^8.2" —— 约束太宽，求解器暴力穷举组合
删了 composer.lock 或没提交它 —— install 实际退化为 update，重新解析整棵树
repositories 里写了已下线的私有源地址 —— Composer 逐个超时才 fallback，单次重试就 30 秒

验证方式：进项目根目录，跑 composer install -vvv，看日志开头是否卡在 Resolving dependencies...；如果是，换镜像完全无效，得改 composer.json。

`composer config -g repo.packagist` 怎么写才真生效？

这条命令错一个字符就静默失效，且不报错。必须同时满足四点：

带 -g：否则只改当前目录下的 composer.json，换项目就失效
键名是 repo.packagist（单数 repo），不是 repos.packagist（多一个 s）
中间的 composer 是 type 值，不能省 —— 完整写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
URL 必须 HTTPS + 末尾带 /：少斜杠会拼出 /packages.json 路径导致 404

验证是否写入成功：composer config -g repo.packagist 输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或只返回 URL 字符串（新版 Composer 行为），都说明失败。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

CI/CD 里 `composer install` 必加的四个参数

光换镜像只是第一步。生产部署脚本里漏掉任一参数，都会让冷部署多耗 1–2 分钟：

--no-dev：跳过 require-dev，省掉 PHPUnit、PHPStan 等大体积包，节省 30%+ 时间
--prefer-dist：强制走 ZIP 包，避免 git clone 的 I/O 和网络开销；镜像未缓存 dist 包时会 fallback 到 source，但加这个能压住 fallback 概率
--optimize-autoloader（或 -o）：生成 vendor/autoload_classmap.php，跳过运行时文件扫描
--classmap-authoritative（或 -a）：告诉自动加载器“不在 classmap 里 = 真没有”，彻底禁用 PSR-4 动态查找 —— Serverless 冷启动从 900ms 降到 300ms 的关键

完整推荐命令：composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-progress。注意：--classmap-authoritative 不能在本地开发中启用，否则新增类会直接报 Class not found。

宝塔、Docker、Serverless 环境里镜像为啥不生效？

全局配置写在 ~/.composer/config.json，但执行用户决定读哪个文件：

宝塔「一键部署」默认以 www 用户运行 → 你用 root 配的镜像，www 根本读不到
Docker 构建时用 USER runner，但 composer config -g 写进了 root 的配置 → 构建阶段仍走官方源
Serverless 函数每次冷启动都是全新容器，~/.composer 不存在 → 必须在 Dockerfile 或构建脚本里显式配镜像

解决方法统一：确认实际执行命令的 UID（ps aux | grep composer 或查日志），然后切到该用户再跑配置命令。例如给宝塔配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。

最易被忽略的一点：配完镜像必须 composer clear-cache。旧缓存里存着 packagist.org 的元数据，Composer 会优先读缓存再联网，看起来像“不动”，其实是反复重试 TLS 握手失败。清完缓存后，再用 composer install -vvv 看日志里是否出现 mirrors.aliyun.com —— 这才是唯一可信的生效证据。