PHP多版本配置与下载教程

phpEnv（大写E）是Windows平台专为多PHP版本共存设计的集成环境，内置Apache、MySQL及可切换的PHP版本，但虚拟主机需手动配置httpd-vhosts.conf并启用mod_proxy_fcgi，通过FPM端口（如9074对应PHP 7.4）精准绑定版本；而小写phpenv仅为macOS/Linux下的CLI版本管理器，不包含Web服务器，也无法自动配置虚拟主机——二者名称相似却定位迥异，极易混淆。无论你是在Windows上追求开箱即用的多版本开发环境，还是在类Unix系统中需要命令行灵活切换PHP，都必须厘清“谁管理PHP二进制”与“谁处理HTTP请求”的职责边界，否则即便php -v显示正确版本，浏览器仍可能运行旧版PHP。

phpEnv 本身不提供虚拟主机功能，它只是 PHP 版本管理工具 —— 想配虚拟主机，得靠 Apache 或 Nginx 配合已安装的 PHP 版本来实现。

phpEnv 下载地址和安装方式

官方下载页是 https://www.phpenv.cn/download.html，但注意：这个站点分发的是 Windows 下的「phpEnv 集成环境」（含 Apache + MySQL + PHP 多版本），和 GitHub 上开源的 phpenv（类 rbenv 的 CLI 工具，仅管理 PHP）不是同一项目，容易混淆。

• 如果你在 Windows 上想要开箱即用的多版本 + 虚拟主机，直接下 phpEnv（带大写 E）安装包，解压即用，自带 Apache 配置入口
• 如果你在 macOS/Linux 做开发，需要命令行灵活切换 PHP 版本，应该用小写的 phpenv（GitHub 项目：https://github.com/phpenv/phpenv），它不带 Web 服务器
• Windows 用户若误装了小写 phpenv（如通过 Git Bash 安装），将无法直接配置虚拟主机，因为没集成 Apache

Windows phpEnv 配置多版本虚拟主机的关键步骤

以官网下载的 Windows 版 phpEnv 为例，它默认使用 Apache，PHP 版本可切换，但虚拟主机需手动配置：

• 打开 phpEnv 安装目录下的 Apache/conf/extra/httpd-vhosts.conf，添加类似这样的段落：

<VirtualHost *:80>
    DocumentRoot "D:/projects/v1"
    ServerName v1.test
    <Directory "D:/projects/v1">
        Require all granted
    </Directory>
    # 关键：指定此站点用 PHP 7.4
    SetHandler "proxy:fcgi://127.0.0.1:9074"
</VirtualHost>

• 每个 PHP 版本对应一个独立的 FPM 端口（如 7.4 → 9074，8.2 → 9082），端口列表可在 phpEnv 主界面「PHP 版本」页查看
• 必须同时在 httpd.conf 中启用 mod_proxy_fcgi 和 mod_proxy，否则 SetHandler proxy:fcgi://... 会报 500 错误
• 修改后要点击 phpEnv 界面右上角的「重载 Apache」按钮，不能只重启服务

为什么 phpenv（小写）不能直接配虚拟主机

因为 phpenv 是纯版本管理器，它只做三件事：编译安装 PHP、生成 shims、读取 .php-version 切换 php 命令指向。它不启动任何 Web 服务，也不修改 Apache/Nginx 配置。

• 你用 phpenv install 8.3.13 后，PHP 二进制在 ~/.phpenv/versions/8.3.13/bin/php，但 Apache 不知道它的位置
• 要让 Apache 调用特定版本，得手动配置 LoadModule php_module 路径，或改用 PHP-FPM + Proxy，而 phpenv 不帮你生成或管理这些进程
• 常见错误：phpenv global 8.3.13 后 php -v 显示正确，但浏览器跑的还是旧版 —— 因为 Web 服务器根本没连到这个版本

真正麻烦的地方不在下载或安装，而在「哪个 phpEnv」和「谁负责 Web 请求路由」之间的职责边界。Windows 用户容易以为点开图形界面就能自动绑定域名和版本，实际仍要手改 Apache 配置；macOS/Linux 用户则可能花半天装好 phpenv，却卡在 Nginx 怎么把请求转给指定 PHP-FPM socket 上 —— 这些都不是 phpenv 的工作范围。

文中关于phpenv的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP多版本配置与下载教程》文章吧，也可关注golang学习网公众号了解相关技术文章。