Composer安装及镜像配置常见问题解答-composer-PHP中文网

根本原因是配置写错或被覆盖：键名必须为repo.packagist（单数）、type值必填composer、url末尾须带/、必须加-g；且项目级repositories字段会无条件屏蔽全局配置。

composer安装及镜像配置常见问题解答

Composer 命令找不到、composer install 卡在 Resolving dependencies、换源后还是走 packagist.org——这三类问题占新手实际卡点的 80% 以上，根本原因不是网络差，而是配置写错或被覆盖。

command not found: composer 怎么修

这不是没装上，是系统压根没找到可执行文件。Linux/macOS 下常见于权限或 PATH 缺失；Windows 下多因 PHP 路径没进环境变量。

composer.phar 移到 /usr/local/bin/composer 后，必须加执行权限：sudo chmod +x /usr/local/bin/composer
确认 /usr/local/bin 在 $PATH 里：echo $PATH | grep /usr/local/bin，没输出就得补：export PATH="/usr/local/bin:$PATH"（记得写进 ~/.zshrc 或 ~/.bashrc）
Windows 用户若用 CMD 提示 PHP not found，说明 php.exe 所在目录（如 C:\php）没加进系统 PATH，需手动添加并重启终端
全局 bin 目录（~/.composer/vendor/bin）也要加进 PATH，否则 composer global require laravel/installer 装完也敲不出 laravel 命令

composer install 卡住或报 404/500 怎么查

卡在 Resolving dependencies 不是网慢，是镜像根本没生效。华为云、阿里云等主流镜像地址已多次变更，旧教程里的路径基本都失效了。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

华为云唯一稳定地址是：https://repo.huaweicloud.com/repository/php/（注意末尾斜杠 ✅，少斜杠 ❌）
阿里云当前有效地址：https://mirrors.aliyun.com/composer/；腾讯云：https://mirrors.cloud.tencent.com/composer/
命令必须带 composer 这个 type 参数：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉 composer 就静默失效
项目根目录下只要存在 composer.json 并含 "repositories" 字段（哪怕空数组），全局镜像立刻被无视

怎么确认镜像真的在用

别信 composer config -g repo.packagist 的输出，它只显示“你写了什么”，不反映“实际用了什么”。真实请求域名才是唯一判断依据。

运行：composer clear-cache && composer require monolog/monolog -vvv 2>&1 | grep "GET\|Downloading"，看日志里出现的是 aliyun.com 还是 packagist.org
composer diagnose 输出里如果还有 Repo packagist.org is default，说明镜像没接管成功，大概率是键名写成 repos.packagist（多一个 s）或 URL 缺少 /
Docker 构建时，RUN composer config -g 写在构建阶段，但运行阶段用的是另一个 PHP 镜像——配置不会自动同步，得在 PHP 容器里重新配或把 config.json COPY 进去

composer config -g 报错或静默失败怎么办

报错常因 PHP 环境限制，静默失败则几乎全是命令格式错误。Composer 2.9.6+ 对格式更严格，老写法在新版里直接忽略。

检查 php.ini 中 disable_functions 是否禁用了 proc_open 或 putenv，禁用会导致 config -g 失败
验证命令四要素：键名必须是 repo.packagist（单数）、第三个参数必须是 composer（type 值）、URL 必须以 / 结尾、必须加 -g
CI/CD 场景（如华为云 DevCloud）建议改用环境变量注入：COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/，比全局配置更可控
升级 Composer 到 2.9.6+：composer self-update，旧版本对 HTTPS 路径拼接和镜像协议兼容性差