答案是PHP CLI环境未就绪导致composer install无法运行,必须同时满足php -v可执行、openssl/curl扩展启用、php.exe目录已加入PATH;镜像配置错误(键名repo.packagist、type为composer、URL末尾带/)或项目级repositories字段覆盖全局配置也会导致卡在“Loading composer repositories…”。

php -v 不通,别碰 composer install
命令根本跑不起来,不是 composer install 本身有问题,而是 PHP CLI 环境没就绪。必须同时满足三件事:
-
php -v能输出版本(比如PHP 8.3.5 (cli)),否则composer install连启动都做不到 -
php -m | findstr openssl要能打出openssl,否则 HTTPS 请求会失败,卡在 “Loading composer repositories…” - 系统
Path环境变量里得有php.exe所在目录(如C:\xampp\php),**不能带php.exe文件名,只填目录路径**
常见错误:CMD 里输 php -v 报“不是内部或外部命令”;或者能出版本但提示 Unable to load dynamic library 'php_openssl.dll'——这时要检查 php.ini,确认以下三行已取消注释:
extension=php_openssl.dll extension=php_curl.dll extension=php_zlib.dll
composer install 卡在 “Loading composer repositories…” 怎么办
这不是网速慢,是默认源 packagist.org 在 Windows 上 HTTPS 握手 + DNS 解析容易超时,尤其国内环境。必须换镜像源。
- 全局换源(推荐):
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果项目根目录已有
composer.json并含repositories字段,全局配置会被无视——得删掉或把里面地址也改成https://mirrors.aliyun.com/composer/ - 换源后不用重启终端,但若之前卡住过,建议删掉
composer.lock和vendor目录再重试
运行 composer install 前要确认的三件事
很多人跳过检查直接执行,结果报错一堆却不知从哪下手。
- 当前目录下必须有
composer.json(哪怕空文件也要存在),否则报Could not find a composer.json file - 确保
composer.lock存在且与composer.json版本一致;若刚改过composer.json,应先运行composer update或删掉composer.lock再install - Windows 下路径含中文或空格可能导致某些包安装失败,建议项目路径用纯英文、无空格(如
D:\projects\myapp)
composer install 成功后 vendor 目录为空或报权限错误
常见于杀毒软件拦截、UAC 限制或用户权限不足。
- 关闭实时防护(特别是 Windows Defender 或第三方杀软),再试一次
- 不要以普通用户身份在
C:\Program Files或C:\Windows下运行composer install,这类路径需要管理员权限,但 Composer 默认不请求提升 - 如果用 WAMP/XAMPP,别在
www子目录里直接装——有些发行版对vendor目录做了写入限制,建议把项目放在D:\myproject这类非系统盘路径
最常被忽略的是:换源和删 composer.lock 往往比重装 Composer 有用得多。











