PHPStudy 默认不带 Composer,需手动配置PATH并验证PHP CLI可用性,再下载composer.phar、创建composer.bat、添加路径到环境变量,最后启用mbstring、zip等扩展并配置镜像源。

PHPStudy 自带的 PHP 环境默认不包含 Composer,也不能直接双击 composer.phar 运行——必须手动配置系统级或用户级的 PATH,并验证 PHP CLI 是否可用。
确认 PHPStudy 的 PHP 命令行(CLI)路径是否可用
Composer 本质是 PHP 脚本,依赖 php 命令。PHPStudy 多版本共存,容易选错路径:
- 打开 PHPStudy → 点击「其他选项菜单」→ 「网站环境」→ 记下当前启用的 PHP 版本(如
php-7.4.33) - 进入对应目录,典型路径为:
C:\phpstudy_pro\Extensions\php\php-7.4.33\php.exe(注意是php.exe,不是php-cgi.exe) - 在命令行中运行:
C:\phpstudy_pro\Extensions\php\php-7.4.33\php.exe -v,能输出版本号才算可用 - 如果提示“不是内部或外部命令”,说明该路径未加入系统
PATH,或路径含中文/空格(PHPStudy 安装到C:\根目录最稳妥)
下载 composer.phar 并配置成全局命令 composer
不能只把 composer.phar 放桌面点开——要让它在任意目录下都能执行 composer install:
- 从官网下载最新
composer.phar:https://www.php.cn/link/594ca739e3609243a6b6a3dd8d871114(右键另存为,不要用浏览器直接打开) - 把它放到 PHP 扩展目录里,例如:
C:\phpstudy_pro\Extensions\php\php-7.4.33\composer.phar - 新建一个同名批处理文件
composer.bat,内容仅一行:@"C:\phpstudy_pro\Extensions\php\php-7.4.33\php.exe" "%~dp0composer.phar" %*
(注意路径需和你实际一致) - 将该目录(
C:\phpstudy_pro\Extensions\php\php-7.4.33\)添加进系统环境变量PATH - 重启命令行,运行
composer -V,出现版本号即成功
常见报错与绕过方法
即使配置完成,仍可能因权限、网络或 PHP 配置失败:
立即学习“PHP免费学习笔记(深入)”;
-
Could not open input file: composer.phar:composer.bat中的路径写错,或%~dp0没正确解析(建议用绝对路径代替) -
cURL error 60: SSL certificate problem:PHPStudy 默认关闭了 CA 证书校验,临时解决可加-d openssl.cafile=参数,但更推荐在php.ini中设置:curl.cainfo = "C:\phpstudy_pro\Extensions\php\php-7.4.33\cacert.pem"(需自行下载cacert.pem) -
mbstring extension is missing或zip extension is missing:打开 PHPStudy →「软件管理」→「PHP 扩展」→ 勾选mbstring、zip、openssl,然后重启 Apache/Nginx - 国内访问慢:执行一次
composer config -g repo.packagist composer https://packagist.phpcomposer.com(已失效)或改用阿里云镜像:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
真正卡住的地方往往不是 Composer 本身,而是 PHPStudy 的 CLI 环境和扩展没对齐 Web 环境——php -m 和 phpinfo() 显示的已启用模块可能完全不同。











