phpenv 不并发运行多版本PHP，而是通过shims机制按需秒级切换：优先级为shell>local>global，需PATH与phpenv init配对配置并重载shell，安装后必须执行phpenv rehash。
phpenv 本身不“同时运行”多个 PHP 版本，而是按需切换 —— 同一时刻只激活一个版本，但能秒级在不同项目间隔离使用不同版本。关键不是并发执行，而是路径重定向 + shims 机制确保 php 命令始终指向你指定的版本。
安装 phpenv 时 PATH 和 init 必须配对生效
很多用户执行 phpenv --version 报错或提示 command not found，根本原因是只加了 PATH 没跑 phpenv init -，或者 shell 配置没重载。
- 必须把这两行一起写入
~/.bashrc或~/.zshrc（别分两次 echo）：export PATH="$HOME/.phpenv/bin:$PATH"eval "$(phpenv init -)" - 改完后一定要执行
source ~/.zshrc（Zsh 用户）或source ~/.bashrc（Bash 用户），exec $SHELL -l有时会跳过 profile 加载，不可靠 - 验证是否生效：运行
which php，输出应为~/.phpenv/shims/php；若仍是/usr/bin/php，说明 shims 未接管，phpenv init没起作用
phpenv install 失败常见于系统依赖缺失
phpenv install 实际调用的是 php-build 插件编译源码，不是下载二进制包，所以失败多因缺编译工具或头文件。
- Ubuntu/Debian 系统必须先装：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev - macOS（Homebrew）需确认
openssl@3、zlib、libxml2已安装且pkg-config可用 - 遇到 configure 报错 “not found” 类提示，优先查
which pkg-config和pkg-config --modversion openssl是否正常 - 可临时加编译参数绕过某些模块，例如：
PHP_BUILD_CONFIGURE_OPTS="--without-gdbm" phpenv install 8.3.13
本地版本（local）和全局版本（global）的优先级关系
phpenv 的版本选择是三级覆盖：shell > local > global。最容易被忽略的是 .php-version 文件的格式和位置。
立即学习“PHP免费学习笔记（深入）”；
-
phpenv local 8.2.18会在当前目录生成.php-version，内容只能是纯版本号（如8.2.18），不能带空格或注释 - 该文件必须位于你执行
php命令时的**当前工作目录**或其任意父目录中才生效；进入子目录不会自动继承 -
phpenv shell 8.1.0是临时会话级设置，关闭终端即失效，适合快速测试，但 CI 脚本里慎用（不可靠） - 执行
phpenv versions时带*的才是当前生效版本；php -v显示的必须和它一致，否则说明 shims 没生效或有其他php在 PATH 前面
真正麻烦的不是装几个版本，而是每次 phpenv install 后忘记运行 phpenv rehash —— 这会导致新装的 php、phpize 等命令在 shims 目录下缺失，php -v 仍调用旧版本。这个步骤不能省，也没有自动触发机制。
