phpEnv并非主流PHP版本管理工具，实际不存在稳定维护的官方项目；推荐使用phpbrew——它支持macOS/Linux下自动编译安装5.6–8.3等多版本PHP，具备完整运行时隔离、扩展管理和FPM集成能力。
phpEnv 不是主流工具，也没有稳定维护的公开仓库；你搜到的所谓“phpEnv”大概率是拼写错误或混淆了 phpbrew、phpenv 或自建脚本。真正在本地多版本 PHP 场景下可靠、可复现、有社区支持的，只有 phpbrew 和 phpenv 两个主流选择——而后者（phpenv）已多年未更新，实际推荐用 phpbrew。
为什么 phpEnv 几乎不存在且不建议使用
查 GitHub、Homebrew、Arch AUR、Debian/Ubuntu 源，均无官方 phpEnv 项目。常见混淆来源包括：
- 把
phpbrew手动改名成phpEnv的私有脚本（不可靠、无文档、难调试） - 误将 Windows 下 phpStudy 的环境变量提示“PHP_ENV”当成工具名
- 某些中文博客把“PHP 环境（PHP Environment）”缩写硬写成
phpEnv，造成术语污染
如果你执行 phpEnv --version 报错 command not found，不是安装漏了，而是根本没这个东西。
phpbrew 是当前最实用的本地多 PHP 版本管理方案
phpbrew 能在 macOS/Linux 上自动编译、安装、隔离不同 PHP 版本（5.6–8.3），每个版本独立存放于 ~/.phpbrew/php/ 下，互不干扰，且自带扩展管理。它不是简单软链接切换，而是真正按版本构建完整运行时。
立即学习“PHP免费学习笔记（深入）”；
关键操作如下：
- 安装后先初始化：
phpbrew init，并按提示将三行source加入~/.bashrc或~/.zshrc - 列出可用版本：
phpbrew known（会显示带构建参数的完整列表，如php-8.2.12 +default +fpm +mysql） - 安装一个版本（含常用扩展）：
phpbrew install 8.2 +default +fpm +pdo +mysql +opcache - 切换 CLI 默认版本：
phpbrew switch 8.2（立即生效，php -v可验证） - 为某个项目临时指定版本：
cd /path/to/project && phpbrew use 7.4（只影响当前 shell）
注意：phpbrew 不管理 Web 服务器（Apache/Nginx）的 PHP 处理器绑定——那是 Web 配置的事，CLI 切换和 Web 运行是两套逻辑。
Web 服务如何绑定不同 PHP-FPM 实例
即使 phpbrew 装好了多个 PHP，Nginx/Apache 仍需手动指向对应版本的 php-fpm.sock 或端口。因为 phpbrew 默认不启用 FPM 服务，需额外启动：
- 启动 PHP 8.2 的 FPM：
phpbrew use 8.2 && php-fpm -y ~/.phpbrew/php/php-8.2.12/etc/php-fpm.conf - 确认监听路径：默认是
127.0.0.1:9002或~/.phpbrew/php/php-8.2.12/var/run/php-fpm.sock（看配置） - Nginx 配置中写死路径：
fastcgi_pass unix:/Users/xxx/.phpbrew/php/php-8.2.12/var/run/php-fpm.sock; - 别忘了
sudo nginx -t && sudo nginx -s reload，否则配置不生效
常见坑：macOS 上默认用 launchd 启动 FPM 容易冲突；建议用 phpbrew fpm start（需装 phpbrew ext install fpm）或直接前台运行调试。
phpenv 已停更，仅作兼容性参考
phpenv 依赖 php-build，最后更新停留在 2020 年，对 PHP 8.1+ 编译支持弱，且无法处理 zts、mysqlnd 等现代扩展依赖。GitHub star 数不足 phpbrew 的 1/5，issue 中大量未回复的编译失败报告。除非你维护一个 2017 年遗留的 CI 脚本，否则不要选它。
若旧项目强制要求 phpenv，唯一可行路径是：git clone https://github.com/phpenv/phpenv.git ~/.phpenv → 手动替换其 plugins/php-build/bin/php-build 为新版 php-build（来自 phpbrew 仓库），再硬编码补丁修复 openssl 3.0 兼容问题——这已超出“切换版本”范畴，属于逆向工程了。
真正的多版本共存难点从来不在安装，而在 FPM socket 权限、opcache 隔离、session.save_path 冲突和 php.ini 加载路径混乱。这些细节，phpbrew 提供了基础支撑，但最终得靠你读 php --ini、phpinfo() 和 ps aux | grep fpm 一行行对齐。
