根本原因是composer调用的不是PHPStudy自带的php.exe，而是系统中其他PHP版本，导致openssl、curl等必需扩展未启用；必须运行composer diagnose验证实际PHP路径及扩展状态。
composer --version能跑通但require失败，根本原因是什么？
不是没装好，而是调用的不是 PHPStudy 自带的 php.exe。Windows 下常见情况是：系统 PATH 里有多个 PHP（比如 VS Code 内置、WAMP 留下的旧版本），composer --version 走的是某个能跑的 PHP，但那个 PHP 的 php.ini 没开 openssl、curl、mbstring——而 composer require 必须依赖这些扩展。
验证方法只有一条：运行 composer diagnose。它会明确告诉你：
- 当前实际使用的
php.ini路径（如果显示php.ini not loaded，说明 PATH 指向了错误 PHP） - 缺失哪些必需扩展（常见报错：
The openssl extension is missing） - CA 证书路径是否可读（若报
SSL certificate problem，需检查curl.cainfo配置）
必须手动指定 PHPStudy 的 php.exe 路径
用 Composer-Setup.exe 安装时，默认会扫描注册表或 PATH 找 PHP，90% 情况下选错。你得主动干预：
- 打开 PHPStudy 控制面板 → 「软件管理」→ 记下当前启用的 PHP 版本（如
php-8.1.10nts） - 进入对应目录，典型路径是：
D:\phpstudy_pro\Extensions\php\php8.1.10nts\php.exe（注意是php.exe，不是php-cgi.exe） - 运行安装程序时，点击 “Browse”，**手动定位到上面那个
php.exe文件** - 务必勾选
Add to PATH；装完立刻关掉所有 CMD/PowerShell 窗口，再新开一个验证
中文路径、空格、镜像源这三处最容易翻车
PHPStudy 安装在 C:\Program Files\ 或桌面带中文名的文件夹里，composer.phar 读取 php.ini 或写缓存时会静默失败；国内直连 packagist.org 基本不可用，不配镜像源就只能等超时。
立即学习“PHP免费学习笔记（深入）”；
- 建议把 PHPStudy 装在纯英文路径下（如
D:\phpstudy_pro） - 运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（2026 年已确认可用） - 如果
composer diagnose报 SSL 错误，去 PHPStudy 的 PHP 设置里，打开对应php.ini，取消注释并修正这一行：curl.cainfo = "D:\phpstudy_pro\Extensions\php\cacert.pem"（路径需与实际一致）
升级 Composer 到 2.x 版本的实操要点
PHPStudy 自带的旧版 Composer（如 1.8.5）在安装 Laravel、Symfony 等现代框架时会直接报错：“Your Composer version is too old”。升级不能只靠 composer self-update，因为它的底层绑定的是安装时指定的 PHP 路径，而旧版可能绑错了。
- 先从 官网 下载最新
composer.phar - 覆盖两个位置：
– PHPStudy 当前启用的 PHP 目录（如D:\phpstudy_pro\Extensions\php\php8.1.10nts\composer.phar）
– Composer 安装目录（如C:\ProgramData\ComposerSetup\bin\composer.phar） - 运行
composer self-update --no-plugins（跳过插件兼容性检查，避免卡住） - 再执行
composer diagnose确认新版已生效且扩展正常
最常被忽略的一点：升级后仍要验证 composer diagnose 输出里的 PHP 路径和扩展状态——很多用户以为版本号更新了就万事大吉，结果 require 还是失败，问题出在底层 PHP 绑定没刷新。
