phpEnv是一款常用的Windows平台PHP集成环境工具,很多开发者会用它快速搭建本地开发环境,而Composer作为PHP的依赖管理工具,配置成全局可用能大幅提升开发效率,不用每次都切换到特定目录执行命令。

确认phpEnv中Composer的安装路径
首先需要找到phpEnv自带的Composer存放位置,默认情况下phpEnv会将Composer放在自身安装目录的toolscomposer路径下。如果你的phpEnv安装在D:phpEnv,那么Composer的完整路径就是D:phpEnvtoolscomposer。
你可以打开phpEnv的安装目录,依次进入tools文件夹,查看是否存在composer目录,里面会有composer.phar文件,这就是Composer的核心执行文件。
配置系统环境变量
要让Composer全局可用,需要把Composer的路径添加到系统的PATH环境变量中,具体步骤如下:
- 右键点击桌面上的
此电脑,选择属性,在弹出的窗口中点击高级系统设置 - 在系统属性窗口中点击
环境变量按钮,在弹出的环境变量窗口中找到系统变量区域的Path变量,选中后点击编辑 - 在编辑环境变量窗口中点击
新建,把你之前确认的Composer路径粘贴进去,比如D:phpEnvtoolscomposer,然后依次点击所有确定按钮保存配置
验证Composer全局配置是否生效
配置完成后需要验证是否生效,按下Win+R组合键,输入cmd打开命令提示符,执行以下命令:
composer --version
如果命令执行后输出了Composer的版本信息,说明全局配置已经成功。如果提示不是内部或外部命令,可以检查环境变量是否添加正确,或者重启命令提示符后再尝试。
配置Composer镜像源(可选)
国内访问默认的Composer官方源速度较慢,可以配置国内镜像源提升依赖下载速度,在命令提示符中执行以下命令:
composer config -g repo.packagist composer https://mirrors.ipipp.com/composer/
配置完成后,后续使用Composer安装依赖时就会从国内镜像源拉取资源,速度会明显提升。
常见问题排查
执行composer命令提示PHP版本不匹配
这种情况是因为系统默认的PHP版本和Composer要求的版本不一致,可以在phpEnv中切换到符合Composer要求的PHP版本,然后把对应PHP的路径也添加到系统PATH环境变量中,注意PHP路径要放在Composer路径之前。
修改环境变量后命令还是不生效
环境变量修改后需要重启所有已经打开的命令提示符窗口,或者重启电脑让配置生效,如果还是不行,可以检查路径是否填写正确,是否有多余的空格或者符号。