phpenv本身不安装php，仅负责版本调度；需配合php-build插件实现编译安装，且必须预先配置系统依赖、正确设置shell环境变量并执行phpenv rehash生成shims，否则phpenv install命令不可用或切换版本无效。
直接装完就能切版本，不用改系统 PATH 或手动软链 —— phpenv 本身不装 PHP，它只管调度；真正装 PHP 得靠 php-build 插件编译，这点很多人一开始没搞清，结果 phpenv install 报错一堆依赖缺失，以为工具坏了。
安装 phpenv 本体和 php-build 插件
先确认你用的是 Bash 还是 Zsh（echo $SHELL），再往对应配置文件里写环境变量。别全抄“~/.profile”，Zsh 用户写 ~/.zshrc 才生效。
- 克隆主程序：
git clone https://github.com/phpenv/phpenv.git ~/.phpenv - 添加路径和初始化（以 Zsh 为例）：
echo 'export PATH="$HOME/.phpenv/bin:$PATH"' >> ~/.zshrc，然后echo 'eval "$(phpenv init -)"' >> ~/.zshrc - 重载配置：
source ~/.zshrc（Bash 用户用~/.bashrc） - 装插件：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build
漏掉插件这步，phpenv install 命令根本不存在 —— 它是插件提供的，不是 phpenv 自带的。
装 PHP 版本前必须装的系统依赖
Ubuntu/Debian 系统跑 phpenv install 8.3.13 失败，90% 是缺编译依赖。别急着 Google 错误里的某一行，先一次性装全：
sudo apt update && sudo apt install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev libxml2-dev libsqlite3-dev libzip-dev libonig-dev- PHP 8.2+ 需要
libonig-dev，老教程常漏掉这个，导致 configure 阶段报oniguruma.h not found - CentOS/RHEL 用户换用
yum或dnf，包名略有差异，比如readline-devel而非libreadline-dev
装完依赖再跑 phpenv install，否则会卡在 configure 或 make 阶段，错误信息又长又散，容易误判。
切换版本后 php -v 不变？检查三个地方
执行了 phpenv local 7.4.33，但 php -v 还是 8.3 —— 不是命令没生效，而是 shell 没走 phpenv 的 shim 机制。
- 运行
which php：如果输出是/usr/bin/php或/opt/php/8.3/bin/php，说明系统自带 PHP 或其他管理器（如update-alternatives）抢在前面了 - 确认当前目录下有
.php-version文件：cat .php-version应该显示7.4.33；没有就手动创建，内容只有一行版本号 - 运行
phpenv rehash：每次新装一个 PHP 版本后都得手动触发一次，否则phpenv不知道该生成哪些 shim
shim 是 phpenv 的核心机制，所有 php、phpize、pear 命令都是它生成的代理脚本，路径必须落在 ~/.phpenv/shims/ 下才有效。
项目级版本锁定靠 .php-version 文件
团队协作时，phpenv local 只改你本地的 .php-version，但这个文件应该提交进 Git —— 否则新人 clone 项目后默认用全局版本，可能直接报错。
- 进项目根目录，运行
phpenv local 7.4.33，它会自动创建.php-version - 检查文件权限：
.php-version必须是普通文本文件，不能是符号链接，否则某些 shell（尤其是 CI 环境）读取失败 - CI 脚本里别用
phpenv shell（临时会话级），要用phpenv local或直接echo "8.3.13" > .php-version，更稳定
很多人忽略 .php-version 的实际作用：它不是“建议”，而是 phpenv 查找版本的唯一依据（优先级高于 global），一旦存在且格式正确，进目录就自动生效，不需要额外命令。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
