利用Composer中文镜像快速同步PHP项目依赖快照-composer-PHP中文网

答案是执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，末尾斜杠不可省略，该命令全局生效且优先级高于项目配置。

利用composer中文镜像快速同步php项目依赖快照

Composer 默认源在国外，国内直接 composer install 或 composer update 极易卡在 Downloading... 或报 Connection timed out 错误——换中文镜像不是“可选优化”，而是必须操作。

阿里云镜像稳定、同步及时（通常滞后主源

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

验证是否生效：运行 composer config -g repo.packagist，输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。

该配置写入全局 ~/.composer/config.json，对所有项目生效
若已存在项目级配置（composer.json 同级有 composer.lock 或自定义 config.repo），项目级会覆盖全局，需手动清理或重置
不推荐用 composer config repo.packagist ...（无 -g）设为当前目录级，容易遗漏且难以追踪

适合 CI 环境、Docker 构建或临时调试，避免污染本地配置：

composer install --repository=https://mirrors.aliyun.com/composer/

注意：--repository 仅影响包元数据拉取（即 packages.json 列表），但实际 ZIP 包仍可能走原始下载链接——除非镜像本身支持完整代理（阿里云镜像支持）。更稳妥的方式是配合 --prefer-dist 和环境变量：

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

设置 COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ 再运行 composer install
--prefer-dist 强制走 ZIP 包而非 Git 克隆，大幅减少网络请求次数
某些私有包若未在镜像中同步（如未提交至 Packagist 的私有仓库），此方式会失败，需单独配置 repositories

即使换了镜像，composer update 仍可能卡住，常见原因不是源问题，而是解析逻辑本身：

composer.lock 中记录的 dist URL 若仍是原始地址（如 https://api.github.com/...），Composer 会尝试直连——镜像只代理元数据，不代理所有 dist 包。此时需加 --with-dependencies 并确保镜像支持 dist 重写（阿里云镜像已启用）
PHP 版本约束太松（如 "php": "^7.4 || ^8.0"）会导致依赖求解器遍历大量版本组合，耗时激增。建议在 composer.json 中显式锁定 platform.php：

"config": {
  "platform": {
    "php": "8.1.25"
  }
}

这能跳过运行时 PHP 版本检测，加速 solver 过程。

阿里云、腾讯云等主流镜像极少完全失效，但个别新发布包可能存在数分钟同步延迟。若遇到 Could not find package xxx at version yyy：

先运行 composer clear-cache 清除本地缓存（尤其是 ~/.composer/cache/repo/https---mirrors.aliyun.com-composer/）
用 curl -I https://mirrors.aliyun.com/composer/p2/vimeo/psr-http-message-bridge.json 手动测镜像是否返回 200，排除 DNS 或网络拦截
确认包名拼写（vimeo/psr-http-message-bridge 不是 psr/http-message-bridge），Composer 不自动纠错
紧急情况下可临时切回官方源： composer config -g repo.packagist composer https://packagist.org，但务必记得切回