phpEnv多版本下载安装 phpEnv零基础上手教程-php教程-PHP中文网

phpenv是windows专用图形化php集成环境，提供apache、mysql及多版本php预编译包的一键切换，不修改系统path，也不支持命令行phpenv语法；其核心功能通过界面操作实现，如“php版本管理”添加zip包、“应用”后自动重启apache生效。

phpenv多版本下载安装 phpenv零基础上手教程

phpEnv 是 Windows 下的 PHP 集成环境（注意：不是 phpenv，后者是类 Unix 系统的多版本管理工具），主打“开箱即用”，但名字容易混淆，很多新手卡在第一步——分不清它和 phpenv、phpbrew 的区别。直接说结论：你要在 Windows 上快速切换 PHP 7.4/8.1/8.2/8.3 并配好 Apache + MySQL，就用官网版 phpEnv；想在 macOS/Linux 命令行里用 phpenv global 8.2 那套流程，那得换工具，phpEnv 不支持。

怎么确认你下的是真正的 phpEnv（不是 phpenv）

很多人搜“phpenv 安装”结果点进 https://www.php.cn/link/d01e50a1df779a3b2ee9cf8776e02303，这确实是官方站，但注意：这个软件是 Windows 桌面应用，安装后有图形界面，启动后托盘图标是蓝色齿轮。而 GitHub 上的 phpenv（phpenv/phpenv）是纯命令行工具，只支持 Bash/Zsh，Windows 下必须靠 WSL 才能用。

常见误判现象：

执行 phpenv --version 报错 command not found → 你装的是图形版 phpEnv，没提供命令行入口
双击安装包弹出向导式界面 → 是 phpEnv，不是 phpenv
安装目录里有 Apache24、MySQL80、php-8.2.12-Win32-vs16-x64 这类文件夹 → 确认是 phpEnv

下载安装 phpEnv 后，PHP 多版本怎么加、怎么切

phpEnv 的多版本管理靠的是“预编译二进制包 + 图形界面切换”，不是源码编译，所以速度快、不报错，但也意味着你不能自定义 --with-openssl 这类参数。

操作步骤：

打开 phpEnv 主界面 → 点击左上角「软件」→「PHP 版本管理」
点击「添加版本」→ 选择已下载好的 ZIP 包（如 php-8.3.5-Win32-vs16-x64.zip），或直接点「在线获取」选版本下载（需开启 CDN 加速）
添加完成后，回到主界面，在「PHP 版本」下拉框里选中目标版本（如 8.3.5）→ 点「应用」
此时 Apache 会自动重启，phpinfo() 显示的版本即为当前生效版本

注意两个坑：

不同 PHP 版本的 ext 扩展目录结构可能不兼容（比如 8.1 的 redis.dll 放到 8.3 下会提示 PHP Startup: Unable to load dynamic library 'redis'），扩展必须用对应版本编译的 DLL
切换版本后，composer 默认仍调用旧版本的 php.exe，需手动改 composer.bat 里的路径，或在命令行里用绝对路径调用：C:\phpEnv\php\php-8.3.5\php.exe C:\phpEnv\composer.phar install

为什么 phpEnv 切换版本后，命令行 php -v 还是旧版本

因为 phpEnv **不修改系统 PATH**，也不接管全局 php 命令。它只改 Apache 的模块加载路径和内置 Web 服务器的绑定逻辑。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

这意味着：

你在 CMD/PowerShell 里敲 php -v，显示的是你之前手动配置的 PATH 里的那个 PHP（比如 XAMPP 自带的）
phpEnv 自带的命令行 PHP 位于：C:\phpEnv\php\php-8.2.12\php.exe（路径随版本变化）
如果真需要命令行也同步，只能自己写个批处理脚本，或把当前选中的 PHP 目录加进系统 PATH（但每次切换都要手动改，不推荐）

更实际的做法是：开发时用 phpEnv 内置服务跑项目，调试 CLI 脚本时，明确指定 PHP 路径，例如：

C:\phpEnv\php\php-8.3.5\php.exe artisan migrate

这样既避免 PATH 冲突，又确保环境一致。

phpEnv 和 Composer 协同工作的关键点

phpEnv 自带 composer，但默认不配置国内镜像，首次 create-project 极易超时失败。

必须做的三件事：

启动 phpEnv 后，点「软件」→「Composer 设置」→ 开启「阿里云镜像」或「腾讯云镜像」
确认 Composer 使用的是当前激活的 PHP 版本：在「Composer 设置」页底部点「测试版本」，输出应和 phpinfo() 一致
如果项目依赖了 ext-sodium 或 ext-pdo_sqlsrv，注意这些扩展在 phpEnv 的 PHP 包里默认未启用，要进「PHP 设置」→「扩展管理」里手动勾选并重启 Apache

一个容易被忽略的细节：phpEnv 的 composer 是封装过的，它不读取用户家目录下的 composer.json 全局配置，所有设置必须在图形界面里完成，否则 composer config -g 的改动无效。