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 配置失败: