怎么快速安装PHP依赖？使用Composer中文镜像加速-composer-PHP中文网

composer全局镜像配置不生效的三大硬性条件是：键名必须为repo.packagist（非repos.packagist）、type值必须显式传入composer、url须为https且末尾带斜杠；项目级配置更可靠，因ci/宝塔等环境常以www-data或runner用户运行，读不到root或个人用户的全局配置。

怎么快速安装php依赖？使用composer中文镜像加速

直接换阿里云或清华镜像源，composer install 从卡住变秒过——但配错一个字符（比如少个斜杠、漏掉 composer 类型参数）就等于没配，仍直连国外源。

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

这条命令不报错，但实际没走镜像，90% 是因为三个硬性条件缺一不可：

repo.packagist 键名不能写成 repos.packagist（多一个 s 就被完全忽略）
中间必须显式传入 composer 作为 type 值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ ✅；漏掉 composer 就 fallback 到官方源 ❌
URL 必须是 HTTPS 且末尾带斜杠：https://mirrors.aliyun.com/composer/ ✅；https://mirrors.aliyun.com/composer ❌（少斜杠会导致请求路径拼成 /composerpackages.json，返回 404）

验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON。空、null、或仍是 https://packagist.org，说明根本没成功。

项目级配置比全局更可靠，尤其在 CI 和宝塔里

全局配置写在 ~/.composer/config.json，但宝塔默认用 www 用户执行，CI 流水线用 runner 用户，Docker 容器可能是 www-data —— 它们读不到你本地 root 或个人账户下的配置。

btpanel phpsite 宝塔面板PHP网站

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

下载

进项目根目录，运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会自动向 composer.json 的 repositories 字段追加条目，不破坏已有私有源
如果 composer.json 原本是 "repositories": {}，命令会转为标准数组并插入；如果是 "repositories": []，需先手动改成对象结构，否则报错
改完务必运行 composer update --lock，让 composer.lock 记录新源地址，否则首次 install 仍按旧锁文件拉包

卡在 `Resolving dependencies`？换镜像完全没用

镜像只加速下载环节（Downloading、Fetching package），不解决依赖求解慢的问题。如果你发现 composer update 卡在这一步超过 10 秒，大概率是：

composer.json 里写了模糊版本号，比如 "monolog/monolog": "*" 或 "^1.0" 范围太宽
本地 PHP 版本和 "php": "^8.1" 声明不匹配，Composer 反复尝试兼容版本
启用了 xdebug：会让解析速度下降 5–10 倍，装依赖前先关掉：php -d xdebug.mode=off composer install
require-dev 包太多，或嵌套了未同步到镜像的私有源

这时 -vvv 日志里看不到 mirrors. 字样，说明根本没发 HTTP 请求——问题不在网络，而在约束本身。

CI 和宝塔里最容易被忽略的权限坑

你在终端用 root 执行了 composer config -g，但宝塔「一键部署」或 GitHub Actions 的 runner 是以其他用户身份运行的，它们读的是各自家目录下的 .composer/config.json。

查清实际执行用户：whoami 或看日志 UID
给 www 用户单独配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
CI 脚本中别依赖全局配置，改用临时参数：composer install -vvv --repository-url=https://mirrors.aliyun.com/composer/
别忘了 composer clear-cache：缓存残留可能让旧配置继续生效

真正卡住时，唯一能确认镜像是否命中的方式，是加 -vvv 看终端输出的真实请求 URL —— 光看命令跑完没报错，毫无意义。