直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 即可全局配置镜像,使 create-project 等命令自动加速;需确保键名正确、type 为 composer、url 以 / 结尾,且项目级配置未覆盖。

直接用 composer create-project 装 ThinkPHP 8,不设镜像大概率会卡在 Installing topthink/think (v8.0.12) 这一步,甚至报 Connection timed out 或 failed to open stream: Connection refused。根本原因不是你网络差,而是 Composer 默认连的是国外 packagist.org,国内直连极不稳定。
composer config -g repo.packagist 是最稳的全局方案
这个命令改的是 Composer 全局配置,所有项目都生效,不用每次进项目再设。执行后,后续所有 composer install、composer require、composer create-project 都自动走镜像源。
- 阿里云镜像(推荐,实测华北/华东地区延迟最低):
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云镜像(华南用户可优先试):
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云镜像(兼容性稍弱,但同步频率高):
composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/
设完用 composer config -g -l 检查是否写入成功,输出里应有 repo.packagist 对应的 URL。
create-project 命令本身不支持临时镜像参数
别试 composer create-project --repository-url=xxx,这个参数只对私有仓库有效,对 packagist 镜像无效。强行加会报错 Could not find package topthink/think at any version。
- 正确做法:先运行镜像配置命令,再跑
composer create-project topthink/think your-project-name - 如果项目目录非空,会直接失败,提示
Project directory xxx is not empty,得先清空或换路径 - 首次安装耗时仍可能 2–5 分钟(毕竟要解压 + 安装几十个依赖),但不会卡死或超时
临时失效?检查是否被项目级配置覆盖
有时候全局设了,但进某个项目后 composer install 还是慢,大概率是该项目根目录下存在 composer.json 里的 repositories 字段手动指定了源,或者本地有 composer.json 的 config 覆盖了全局设置。
- 查项目级配置:
composer config --list(不加-g),看输出里repo.packagist是否还是默认地址 - 删掉项目内
composer.json中的"repositories"或"config"相关块,再试 - 极端情况可加
--no-plugins参数绕过插件干扰:composer create-project topthink/think app --no-plugins
镜像不是万能加速器——如果 PHP 版本低于 7.4,或 ext-opcache、ext-curl 没启用,create-project 即使走镜像也会在 autoload 生成阶段报错,这类问题得单独排查扩展状态,不能只盯镜像。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











