phpenv install 不覆盖已安装版本，需先安装新版本（如8.3.13）、执行phpenv rehash、再用phpenv global或local切换，旧版本保留在~/.phpenv/versions/下可手动删除。
phpenv install 不能覆盖已安装版本
直接运行 phpenv install 8.3.13 不会升级已有版本，而是报错提示“version already installed”。phpenv 的设计原则是每个版本路径严格隔离，不允许就地覆盖。
要“更新”一个 PHP 版本（比如把 8.3.12 升到 8.3.13），本质是安装新版本 + 切换指向：
- 先确认当前用的是哪个版本：
phpenv version - 安装目标版本：
phpenv install 8.3.13（需提前装好php-build插件） - 执行
phpenv rehash，让新二进制文件被识别 - 再用
phpenv global 8.3.13或phpenv local 8.3.13切换过去 - 旧版本仍保留在
~/.phpenv/versions/下，可手动删（如rm -rf ~/.phpenv/versions/8.3.12）
切换后 php -v 仍显示旧版本？检查 which php
常见现象：执行了 phpenv global 8.3.13，但 php -v 输出还是 8.2.x。根本原因通常是 PATH 中有其他 PHP 路径优先级更高。
验证方式：
立即学习“PHP免费学习笔记（深入）”；
- 运行
which php—— 正常应输出类似~/.phpenv/shims/php - 如果输出是
/usr/bin/php或/opt/homebrew/bin/php，说明系统自带或包管理器安装的 PHP 挡在了前面 - 检查
echo $PATH，确保~/.phpenv/bin和~/.phpenv/shims在最左侧（即最高优先级） - 若用 zsh，注意配置写在
~/.zshrc而非~/.bash_profile；改完记得source ~/.zshrc
项目级版本失效：.php-version 文件权限或位置错误
在项目根目录运行 phpenv local 8.3.13 会生成 .php-version 文件，但这个文件必须满足两个条件才会生效：
- 文件必须位于当前工作目录（
pwd输出路径）或其任意父目录，且最近的一个才生效（向上查找） - 文件内容只能是纯版本号，比如
8.3.13，不能带空格、注释或多余换行 - 文件权限需可读（
chmod 644 .php-version），某些 CI 环境因 umask 限制可能生成不可读文件 - 如果项目里有
.phpenv-version（旧命名），phpenv 默认不识别，必须重命名为.php-version
phpenv install 失败常见编译依赖缺失
安装 PHP 版本时卡在 configure 或 make 阶段，90% 是系统缺少编译依赖。不同发行版命令不同，但核心库一致：
- Ubuntu/Debian：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev libxml2-dev libsqlite3-dev - macOS（Homebrew）：
brew install autoconf automake openssl@3 libxml2 sqlite3 pkg-config，并设置export PATH="/opt/homebrew/opt/openblas/bin:$PATH"（如需 OpenBLAS） - CentOS/RHEL：
sudo yum groupinstall "Development Tools" && sudo yum install -y openssl-devel libxml2-devel sqlite-devel readline-devel - 关键环境变量（尤其 macOS）：
export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/opt/homebrew/opt/openssl@3"，否则 configure 找不到头文件
每次安装失败后，不要直接重试——先 phpenv uninstall 8.3.13 清掉半成品，再补依赖，否则残留的 config.cache 可能复用错误路径。
