composer --version成功但require失败，是因为调用的不是PhpStudy的PHP：需手动指定php.exe路径、启用openssl/curl等CLI扩展、配置阿里云镜像源，并运行composer diagnose验证。
Composer 在 PHPStudy 里根本不会自动出现，装错 PHP 路径、漏开扩展、PATH 没生效，三者任一出问题，composer --version 就能跑通但 composer require 必然失败。
为什么 composer --version 成功却装不了包？
这是最典型的“假成功”现象：命令能执行，但背后调用的不是 PHPStudy 自带的 php.exe，而是系统里其他版本（比如 WAMP、XAMPP 甚至 Visual Studio Code 自带的 PHP）。结果就是 openssl、curl、mbstring 这些扩展没启用，而报错只显示 cURL error 60 或 The openssl extension is missing，根本不提是哪个 PHP 在干活。
- 必须运行
composer diagnose，它会明确告诉你当前用的是哪个php.ini、哪些扩展缺失、CA 证书路径是否可读 - 如果
diagnose提示php.ini加载失败，说明 PATH 指向了错误的 PHP，或该 PHP 的php.ini路径被硬编码改过 - 别信
php -v和composer --version同时有输出就万事大吉——它们可能用的压根不是同一个php.exe
安装时必须手动指定 PHPStudy 的 php.exe 路径
用 Composer-Setup.exe 图形化安装最省事，但 Windows 下默认会扫注册表或 PATH 找 PHP，极大概率选错。你得主动干预：
- 打开 PHPStudy 控制面板 → 「软件管理」→ 记下当前启用的 PHP 版本（如
php-8.1.10nts） - 进入对应目录，典型路径是：
D:\phpstudy_pro\Extensions\php\php8.1.10nts\php.exe（注意是php.exe，不是php-cgi.exe） - 运行
Composer-Setup.exe时，点击 “Browse”，**手动定位到上面那个php.exe文件**，不要让它自动选 - 务必勾选
Add to PATH；装完立刻关掉所有 CMD/PowerShell 窗口，再新开一个验证
中文路径、空格、镜像源这三处最容易翻车
PHPStudy 安装在 C:\Program Files\ 或桌面带中文名的文件夹里，composer.phar 读取 php.ini 或写缓存时会静默失败；国内网络直连 packagist.org 基本不可用，不配镜像源就只能等超时。
立即学习“PHP免费学习笔记（深入）”；
- PATH 中包含中文或空格（如
C:\Users\张三\AppData\Roaming\Composer）会导致某些包的 autoloader 加载异常，建议把 PHPStudy 装在纯英文路径下（如D:\phpstudy_pro） - 配置阿里云镜像源：运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（2026 年已确认可用） - 如果
composer diagnose报SSL certificate problem，去 PHPStudy 的 PHP 设置里，找到php.ini，取消注释并修正这一行：curl.cainfo = "D:\phpstudy_pro\Extensions\php\php8.1.10nts\cacert.pem"（cacert.pem需自行下载并放对位置）
扩展没开，composer require 就是死循环
PHPStudy 默认关闭多数 CLI 扩展，而 Composer 的依赖解析、HTTPS 下载、ZIP 解压全靠它们撑着。光在「PHP 扩展」界面勾上还不够，得确认 CLI 模式下也生效。
- 打开 PHPStudy → 「软件管理」→ 「PHP 扩展」→ 勾选：
openssl、curl、mbstring、zip、json - 勾完点「应用」后，**必须重启 Apache/Nginx + 重启 PHPStudy 主进程**（不是只点「重启服务」），否则 CLI 模式仍读旧配置
- 验证方式：在 CMD 中运行
D:\phpstudy_pro\Extensions\php\php8.1.10nts\php.exe -m | findstr openssl，有输出才算真开了
真正卡住人的从来不是“怎么装”，而是装完以为好了，结果第一次 require 就崩——因为 diagnose 没跑，扩展没验，镜像没切，PATH 没刷。这些步骤漏掉任意一环，后续所有依赖操作都会在暗处失效。
