怎么提升本地PHP开发的工作效率？开启全局Composer镜像服务！-composer-PHP中文网

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 是正确配置 packagist 镜像的命令，必须严格满足键名准确、类型为 composer、url 含 https 和末尾斜杠三个条件，否则静默失效。

怎么提升本地php开发的工作效率？开启全局composer镜像服务！

composer config -g repo.packagist 这条命令配对了，本地 PHP 开发效率才能真正提起来。不配镜像，composer install 卡在 Downloading 或 Loading composer repositories 是常态，不是你网络差，是默认连 packagist.org 的物理链路和 TLS 握手根本扛不住国内环境。

为什么 `composer config -g repo.packagist` 总是没效果

90% 的失败不是网络问题，而是三个硬性条件漏掉一个就静默失效：

repo.packagist 不能写成 repos.packagist 或 repositories.packagist——多一个 s，命令不报错但完全不生效
第二个参数必须是 composer，这是仓库类型声明，漏掉会导致 Composer fallback 到官方源（尤其在旧版中更隐蔽）
URL 必须是 HTTPS + 末尾带斜杠：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌（少斜杠会拼接出错，返回 404）

验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍显示 https://packagist.org 都说明没写进去。

宝塔、CI、systemd 里镜像不生效？用户权限搞错了

宝塔面板点「一键部署」卡住，不是镜像没配，而是它用 www 用户执行命令，而你 composer config -g 配的是当前登录用户（比如 root）的配置。

First Principles Decomposer

把任何问题拆解为根本真理，再从原子层面重建解决方案。

下载

查实际执行用户：在宝塔【终端】里运行 sudo -u www composer config -g repo.packagist，如果为空，说明该用户没配
正确做法：用对应用户重配，例如 sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
CI 脚本或 systemd 服务同理——别依赖全局配置，改用临时参数更可靠：composer install --repository-url=https://mirrors.aliyun.com/composer/

项目级配置比全局更安全，但命令会清空已有私有源

进项目根目录后执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），这条命令不是追加，而是**全量替换** composer.json 中的 repositories 字段。

如果你原本已定义 Git 私有源（如 "my-vcs": {"type": "vcs", "url": "https://git.example.com/pkg"}），执行后整个 repositories 会被清空
安全做法是手动编辑 composer.json，在 repositories 数组里显式添加 "packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
同时确保根节点（非 repositories 内部）写上 "packagist.org": false，否则私有源和镜像共存时可能冲突

换源后还卡在 Resolving dependencies？那和镜像无关

镜像只加速元数据下载（packages.json、provider-xxx.json）和 tarball 下载，不解决依赖解析阶段的卡顿。

常见真实瓶颈：PHP 内存不足（默认 128M 不够，试 COMPOSER_MEMORY_LIMIT=-1）、Xdebug 启用中（慢 5–10 倍，用 php -d xdebug.mode=off $(which composer) 临时禁用）、platform 配置与实际 PHP 版本不匹配（比如 "php": "7.4" 却在 PHP 8.2 上运行）
composer.lock 残留已下线包也会导致失败，删掉 vendor/ 和 composer.lock 再 composer install --no-cache 更稳妥
验证是否真走镜像：加 -vvv 参数看日志，composer show laravel/framework -vvv 2>&1 | grep "Downloading"，确认 URL 出现 mirrors.aliyun.com 而不是 packagist.org