composer全局镜像配置未生效的主因是配置未写入php服务实际读取的config.json文件，常见原因包括权限不匹配、键名错误（应为repo.packagist而非repos.packagist）、url末尾缺少斜杠，以及curl.cainfo路径错误或含中文/空格导致ssl校验失败。
composer config -g repo.packagist 命令为什么没生效？
很多人执行了composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，但后续composer require还是慢或报错，根本原因是配置没写进 Composer 实际加载的那个配置文件里。常见原因有三个：
- 你在管理员权限的 CMD 里执行了命令，但 PHPStudy 启动的服务（比如 Apache）是以
SYSTEM或www用户身份运行的，它读的是自己的%USERPROFILE%\AppData\Roaming\Composer\config.json，不是你改的那个 - 键名写错：必须是
repo.packagist（单数repo），写成repos.packagist或packagist都会静默失败 - URL 少了末尾斜杠：
https://mirrors.aliyun.com/composer❌，必须是https://mirrors.aliyun.com/composer/✅，否则拼接出错返回 404
验证是否成功，只看这一句输出：composer config -g repo.packagist。如果返回空、null 或 "https://packagist.org"，说明没生效。
PHPStudy 下该用全局配置还是项目级配置？
对新手来说，全局配置（-g）最省事，但容易被覆盖或读错用户上下文；项目级配置更可靠，尤其当你用 PHPStudy 开多个不同版本 PHP 的项目时。建议按这个顺序操作：
- 先在任意目录执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 再进你的项目根目录（含
composer.json），执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 检查项目
composer.json是否自动加了"repositories"字段，内容类似："repositories": {"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}
这样即使全局配置失效，项目本身也能走镜像源。
curl.cainfo 路径不对会导致镜像配置“看起来生效实则失败”
哪怕 composer config -g repo.packagist 返回正确 URL，如果 PHP 的 SSL 校验失败，Composer 仍会 fallback 到官方源并超时——你根本看不到错误提示，只会卡在 downloading。关键点：
- 打开 PHPStudy →「软件管理」→「PHP 设置」→ 找到当前启用的 PHP 版本 → 点击「配置文件」打开
php.ini - 搜索
curl.cainfo，取消注释并填入绝对路径，例如：curl.cainfo = "D:\phpstudy_pro\Extensions\php\php8.1.10nts\cacert.pem"
-
cacert.pem文件需提前下载（Mozilla 官方 CA 包），放在对应 PHP 目录下；路径里不能有中文、空格，也不能用相对路径 - 改完重启 Apache/Nginx，再运行
composer diagnose，确认 “The openssl extension is loaded” 和 “CA bundle is valid” 都显示 OK
别信 composer --version 能跑就代表镜像配置好了
composer --version 只验证命令是否存在和基础 PHP 运行环境，完全不涉及网络、SSL、镜像源逻辑。真正检验镜像是否起作用，必须做一次真实请求：
- 新建测试目录，运行
composer init创建空白composer.json - 执行
composer require monolog/monolog:^2.0 - 观察终端输出：如果看到
Downloading https://mirrors.aliyun.com/composer/...或几秒内开始解包，说明镜像生效；如果卡在Downloading https://repo.packagist.org/...超过 10 秒，基本就是镜像没走通
最常被忽略的是：PHPStudy 安装路径含中文（如 C:\Users\张三\）或空格（如 C:\Program Files\），会导致 cacert.pem 加载失败、composer.phar 缓存写入异常——这些不会报错，只会让镜像配置变成摆设。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
