phpEnv配置不同站点不同PHP版本 phpEnv多PHP版本管理

先说一个核心判断：很多人把 phpEnv 和 phpenv 搞混了，它们压根儿不是一回事。phpEnv（注意大小写）是 Windows 下的图形化集成环境，类似 phpStudy，主打一键部署；而 phpenv 是类 Unix 系统下的命令行 PHP 版本管理器。如果你在 Linux 或 macOS 上想让不同站点跑不同的 PHP 版本，必须用后者，而不是前者。 ### 为什么 phpenv 不能直接配“站点”？ phpenv 的设计粒度是“目录”，不是“域名”或“站点路径”。它靠检测当前 shell 所在目录里有没有 .php-version 文件，来决定调用哪个 PHP 版本。这就带来了一个关键局限： * Apache 或 Nginx 压根儿不会去读 .php-version 文件——它们只认自己配置文件里写的 php-fpm socket 地址或 CGI 路径。 * 你在终端里执行 `phpenv local 8.2.20`，只是让当前目录下的 `php` 命令变成 8.2 版本，但对 Web 服务毫无影响。 * 真正起作用的，是你手动为每个站点配置的独立 PHP-FPM 实例，比如 `php82-fpm`、`php83-fpm`。 ### 如何让不同 Web 站点用不同 PHP 版本？ 核心思路其实很简单：用 phpenv 编译安装多个 PHP 版本 → 为每个版本单独启动对应的 PHP-FPM 服务 → 在 Nginx 或 Apache 配置里分别指向不同的 socket 或端口。 1. **安装多个版本**：`phpenv install 8.2.20` 和 `phpenv install 8.3.13`，前提是提前装好 `php-build` 插件。 2. **找到实际路径**：安装后，PHP 二进制一般在 `~/.phpenv/versions/8.2.20/bin/php`，FPM 二进制在 `.../sbin/php-fpm`。 3. **配置独立的 FPM 实例**：为每个版本写一份 FPM 配置文件（比如 `/etc/php/8.2/fpm/pool.d/site-a.conf`），监听不同的 socket 路径，例如 `listen = /run/php/php8.2-site-a.sock`。 4. **修改 Nginx 配置**：在对应的 `server` 块里，将 `fastcgi_pass` 指向上面配置的 socket：`fastcgi_pass unix:/run/php/php8.2-site-a.sock;`。 5. **别忘了启动服务**：`sudo systemctl start php8.2-fpm`，并设置开机自启。 ### .php-version 文件只对 CLI 有效 这个文件只被 phpenv 在终端环境下读取，只影响你执行 `php --version` 或 `composer install` 时调用的解释器。它完全不会干预 Web Server 的行为，也不会改变 PHP 脚本内的任何运行时环境。 * 在项目根目录执行 `phpenv local 8.3.13`，会自动生成一个内容为 `8.3.13` 的纯文本文件 `.php-version`。 * 这个文件对 PhpStorm、VS Code 这类 IDE 的 CLI 工具链确实有用，但对从浏览器发起的请求毫无感知。 * 如果你发现 `php -v` 命令显示的版本没变，先检查一下 `source ~/.zshrc` 是否执行过，以及 `phpenv init` 的输出有没有正确注入 shell 环境。 ### 容易忽略的关键点 很多人装好了多个 PHP 版本，结果发现 Web 服务还是只认一个，问题往往出在下面几个环节： * **FPM 启动失败但没看日志**：记得用 `sudo journalctl -u php8.3-fpm -n 50 --no-pager` 查看详细错误。 * **socket 权限问题**：确保 `www-data` 用户（或其他 Nginx 运行用户）有权限读写 `/run/php/xxx.sock`。 * **用户/组配置不一致**：PHP-FPM 配置里的 `user` 和 `group` 必须和 Web Server 的用户保持一致，否则会出来 502 错误。 * **别把 `phpenv global` 当系统默认**：`global` 设置只影响你终端进入没有 .php-version 文件的目录时的默认行为，真正的系统级默认版本还是你自己编译安装的。 说一千道一万，实现多版本 Web 支持，靠的是并行运行多个 PHP-FPM 实例。phpenv 在这个流程里只负责一件事——帮你干净、省心地编译和组织这些不同的 PHP 版本。别指望它能替你改 Nginx 配置或者开 systemd 服务，那是你的活。