phpenv不支持“多版本组合”概念，仅管理离散互斥的PHP实例；需逐个执行phpenv install安装版本，再通过global/local/shell命令按需切换，无批量安装功能。
直接说结论：phpenv 本身不提供“多版本组合”概念，它管理的是离散的、互斥的 PHP 安装实例；所谓“组合”，是你在不同场景下主动切换或并存使用的多个已安装版本——不是一键装个“PHP 7.4+8.2+8.3 套餐”，而是分别 phpenv install 7.4.33、phpenv install 8.2.18、phpenv install 8.3.13，再按需调用。
怎么一次性装好几个 PHP 版本
phpenv 没有批量安装命令，但你可以用 shell 循环快速完成多个版本安装。注意：每个版本必须单独编译或下载预编译包（取决于插件配置）。
-
phpenv install命令每次只处理一个版本，失败不会中断后续；建议逐个执行并观察输出 - 常见错误是依赖缺失，比如
configure: error: Cannot find OpenSSL's <evp.h></evp.h>，需提前装系统级依赖：sudo apt install libssl-dev libxml2-dev libcurl4-openssl-dev libbz2-dev libicu-dev（Ubuntu/Debian） - 如果你用的是
php-build插件（推荐），它默认从源码编译，耗时较长；可加--enable-opcache等参数定制，但别漏掉--with-pear（PHP 8.2+ 默认不带，影响pecl使用） - 安装完成后务必运行
phpenv rehash，否则新装的版本无法被 shims 正确识别
为什么 phpenv versions 不显示刚装好的版本
最常见原因是没执行 phpenv rehash，或者安装过程实际失败但终端没报红（比如 configure 阶段警告后继续，但最后 make 失败）。另一个容易忽略的点：你可能在错误的 shell 配置文件里写了初始化语句。
- 检查是否在正确的 shell 配置中启用：Zsh 用户该写进
~/.zshrc，Bash 用户写进~/.bashrc或~/.bash_profile，二者别混用 - 运行
phpenv root看路径是否为$HOME/.phpenv；如果不是，说明eval "$(phpenv init -)"没生效或被覆盖 - 手动验证某个版本是否存在：
ls $(phpenv root)/versions/—— 这里应列出你安装的全部目录名，如7.4.33、8.3.13 - 如果目录存在但
phpenv versions不显示，大概率是rehash没跑，或当前 shell 未加载 phpenv 的 shim 目录（echo $PATH看有没有$HOME/.phpenv/shims）
如何让不同项目自动用不同 PHP 版本
靠的是 .php-version 文件 + 目录层级继承机制，不是靠“组合配置”。它不智能识别项目需求，只读取当前目录或祖先目录里的这个文件。
立即学习“PHP免费学习笔记（深入）”；
- 进入项目根目录，执行
phpenv local 8.2.18，会在当前目录生成.php-version，内容就是8.2.18 - 该文件会被 git 跟踪，团队协作时其他人
git pull后，只要已安装该版本，进入目录就自动生效 - 如果项目嵌套（比如
project-a/submodule-b），子目录没.php-version就继承父目录的；想覆盖就进子目录再执行一次phpenv local - 注意：全局设置（
phpenv global）只是 fallback，一旦遇到任何.php-version，它就被忽略——这点常被误以为“global 设置失效了”
CI/CD 中切换版本总失败，问题出在哪
CI 环境通常用干净容器，phpenv shell 或 phpenv local 在非交互式 shell 下可能不触发自动加载，且没有用户家目录持久化。
- CI 脚本里别依赖
.php-version自动识别，显式用phpenv global 8.3.13更可靠 - 确保每步都检查返回值：
phpenv install 8.3.13 || exit 1，避免静默失败后继续 - 有些 CI 镜像自带 PHP，会干扰 phpenv 的
php命令查找顺序；可在脚本开头加which php和phpenv which php对比路径 - 如果用 GitHub Actions，注意
phpenv init -输出含 shell 函数定义，必须用eval执行，不能只 echo 到文件再 source —— 很多 workflow 因此卡在 “command not found: phpenv”
真正麻烦的不是装多个版本，而是确认每个版本的扩展是否齐全、php.ini 是否按需加载、以及 pecl 安装的扩展是否绑定到对应版本的 phpize —— 这些都没法靠“组合”自动搞定，得一个版本一个版本手工验证。
