Composer 2.5+ 已废弃 repo.packagist 配置项,执行 composer config -g repo.packagist 永远返回空;应改用 composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/(注意 repos 复数形式),并用 composer install -vvv | grep Downloading 验证真实请求域名。

composer config 导出设置报错,基本不是命令本身出问题,而是配置项不存在、权限不对、或 Composer 版本不兼容导致读取失败。直接看报错关键词比盲目重试快得多。
报错显示 "No configuration setting found" 或输出为空
说明你查的 key 根本没存进去,或者写错了路径。Composer 不会报错提示“key 不存在”,只会静默返回空。
-
repo.packagist必须是单数,写成repos.packagist或repositories都无效 - 全局配置必须加
-g,否则只查当前项目composer.json,换目录就找不到 - Composer 2.5+ 已废弃
repo.packagist配置项,composer config -g repo.packagist永远返回空——它根本不再支持这个 key - 验证是否真生效,别信
config输出,用composer install -vvv | grep Downloading看真实请求域名
执行 composer config 报 PHP 函数禁用错误
比如 Call to undefined function putenv() 或 proc_open() 报错,说明 PHP CLI 环境禁用了关键函数,不是 Composer 的锅。
- 运行
php -r "var_dump(function_exists('putenv'));"确认是否被禁 - 检查
php.ini中disable_functions行,删掉putenv、proc_open(注意前后空格和拼写) - 改完必须重启 PHP-FPM/Apache,且新开终端,旧 shell 进程不会自动加载新配置
- 宝塔用户去「PHP 设置」→「禁用函数」列表里手动勾选取消
导出 JSON 配置时提示 "Failed to decode JSON" 或乱码
这通常是因为 ~/.composer/config.json 文件被手动编辑损坏,或含 BOM 头、非法字符、未闭合引号。
- 先用
cat ~/.composer/config.json | python3 -m json.tool(Linux/macOS)或Get-Content ~/.composer/config.json | ConvertFrom-Json(PowerShell)验证格式 - 常见损坏点:最后一行多逗号、中文引号、注释(JSON 不允许)、缩进混用 tab/spaces
- 最稳妥修复方式:备份后删掉整个
~/.composer/config.json,再用composer config -g重新设一次必要项 - Windows 用户注意:
%LOCALAPPDATA%\Composer\config.json路径下文件同样可能损坏
CI/CD 或宝塔环境里 composer config -g 似乎不生效
因为 -g 是按当前用户写入的,而 CI 流水线或宝塔网站实际运行的是 www、nginx 或其他非登录用户。
- 在宝塔里,用
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/单独配 - GitHub Actions 中,确保
composer config -g在同一 job 的同一 runner 上执行,不能拆到不同 step 用不同 user - Docker 构建时,
USER指令切换过用户后,composer config -g写入的是该用户的 home 目录,不是 root 的 - 验证方式永远只有一种:进目标用户 shell,执行
composer install -vvv并抓第一行DownloadingURL
repo.packagist 这个配置项已彻底移除,但文档和老教程还在传。你看到命令成功返回,其实什么都没写进去。这时候靠 composer config 查,永远是空的。


















