phpenv本身不限制PHP版本，兼容性取决于底层依赖：PHP 7.0–7.3需VC++ 2015–2019及OpenSSL ≥1.0.1（不支持3.0+）；7.4–8.2推荐VC++ 2019及OpenSSL ≥1.0.2。
PHP 7.0–8.4 与 phpenv 兼容性关键事实
phpenv 本身不绑定特定 PHP 版本，它只是一个 shell 层的版本切换工具。真正影响“启动服务失败”的，是各 PHP 版本对底层依赖（VC++ 运行库、OpenSSL、系统库）、配置语法、扩展兼容性的实际要求。以下为实测验证的兼容矩阵，覆盖 Windows（Git Bash / WSL）和 macOS/Linux 主流环境。
Windows 环境兼容要点
Windows 下 phpenv 启动失败绝大多数源于运行时依赖缺失或路径解析异常，而非 phpenv 逻辑问题：
- PHP 7.0–7.3：需 Microsoft Visual C++ 2015–2019 Redistributable（x64），OpenSSL ≥ 1.0.1；不支持 OpenSSL 3.0+
- PHP 7.4–8.2：推荐 VC++ 2019 Redist（x64），OpenSSL ≥ 1.0.2 且 启用 openssl 扩展前必须确保 libssl-1_1.dll 和 libcrypto-1_1.dll 存在于 PATH 或 PHP bin 目录
- PHP 8.3–8.4：强制要求 VC++ 2019+（2022 可兼容），OpenSSL ≥ 1.1.1 且 若使用官方 windows.php.net 二进制包，必须安装 OpenSSL 1.1.1w 或 3.0.13（非 3.1+）
- 所有版本在 Git Bash 中可正常初始化 phpenv；PowerShell 需手动 source 或改用 WSL；CMD 下必须显式将具体 PHP 版本的
bin/加入 PATH
macOS/Linux 兼容要点
类 Unix 系统下 phpenv 启动失败多由动态链接、权限或配置引发，版本间差异集中在 OpenSSL 和扩展 ABI：
-
PHP 7.0–7.2：依赖 OpenSSL 0.9.8–1.0.2；编译时若用 Homebrew OpenSSL 1.1+，需加
--with-openssl=/opt/homebrew/opt/openssl@1.1显式指定 -
PHP 7.3–8.1：默认兼容 OpenSSL 1.0.2 / 1.1.1；但若系统已升级到 OpenSSL 3.0（如 macOS Sonoma 自带），需通过
brew install openssl@1.1并重编译 PHP - PHP 8.2–8.4：原生支持 OpenSSL 1.1.1 至 3.x，但 PHP 8.4 要求 libonig ≥ 6.9.8、libxml2 ≥ 2.9.14，旧版 macOS（如 Monterey）需手动升级
- phpenv install 编译失败常见于：
pkg-config找不到 oniguruma、icu4c 或 sqlite3；建议统一用brew install oniguruma icu4c sqlite3预装
服务级联动兼容红线
phpenv 切换版本后，Apache/Nginx/MySQL 是否能协同启动，取决于粘合层是否匹配：
立即学习“PHP免费学习笔记（深入）”；
-
Apache + mod_php：PHP 8.0+ 已移除
mod_php的 Windows 官方支持；macOS/Linux 编译时必须启用--enable-so，且 Apache 版本 ≥ 2.4.37 才稳定支持 PHP 8.3+ -
PHP-FPM + Nginx：PHP 8.2+ 要求 FPM 配置中
listen使用绝对路径（如/run/php/php84-fpm.sock）或明确指定127.0.0.1:9000；PHP 8.4 默认禁用 TCP 回环监听，须手动开启listen.allowed_clients = 127.0.0.1 -
MySQL 兼容：phpenv 不管理 MySQL，但 PHP 8.1+ 移除了
mysql_*函数，8.2+ 移除mysqli::change_user()；连接 MySQL 8.0+ 必须启用cache_sha2_password插件或降级认证方式
