phpenv本身无内核概念，仅管理多PHP版本路径切换；所谓“升级内核”实为安装并切换PHP版本，需解决编译依赖、PATH配置、shim重建及作用域优先级等问题。
直接说结论：phpenv 本身没有“内核”概念，它不管理 PHP 的运行时内核，只负责在已安装的多个 PHP 版本之间做路径切换。所谓“升级多版本内核”，其实是误用术语——你真正需要的是：安装新 PHP 版本、切换生效、并确保旧版本不受影响。
phpenv install 命令失败：常见依赖缺失
执行 phpenv install 8.3.13 报错（如 configure: error: no acceptable C compiler found）不是 phpenv 问题，而是系统缺少编译工具链：
- 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）：先确认 Xcode Command Line Tools 已装（
xcode-select --install），再装brew install autoconf automake openssl@3 libxml2 sqlite3 - CentOS/RHEL：用
sudo yum groupinstall "Development Tools"+sudo yum install openssl-devel libxml2-devel sqlite3-devel readline-devel
注意：phpenv install 依赖 php-build 插件，若未安装，先执行：git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build
切换后 php -v 不变：PATH 或 shim 未生效
执行 phpenv local 8.3.13 或 phpenv global 8.3.13 后，php -v 仍显示旧版本，大概率是以下两个原因：
立即学习“PHP免费学习笔记（深入）”；
-
which php返回的是系统自带路径（如/usr/bin/php），说明~/.phpenv/shims没被优先加入PATH—— 检查echo $PATH是否含$HOME/.phpenv/shims；没出现就重做初始化：echo 'eval "$(phpenv init -)"' >> ~/.zshrc（或~/.bashrc），再source ~/.zshrc - shim 文件未生成或过期：运行
phpenv rehash强制重建所有垫片（尤其在安装新版本后必须执行） - 当前目录存在
.php-version文件但内容错误（比如写成8.3.13\n多了换行），用cat .php-version确认是否纯版本号
phpenv global / local / shell 切换逻辑差异
三种作用域互不覆盖，优先级从高到低为：shell > local > global。容易混淆的点：
-
phpenv shell 5.6.40只对当前终端会话有效，关掉终端即失效；适合临时测试 -
phpenv local 7.4.33在当前目录生成.php-version文件，cd 进子目录仍生效；但 cd 出该目录就退回到global -
phpenv global 8.3.13写入~/.phpenv/version，是兜底 fallback；但一旦某个目录有.php-version，它就完全不起作用 - 验证当前实际生效版本，别只信
phpenv version，务必用phpenv which php看真实调用路径，再$(phpenv which php) -v确认
最常被忽略的一点：phpenv 不自动安装扩展（如 xdebug、opcache）、不修改 php.ini、也不重启 web server。它只管 CLI 下的 php 命令路径。如果你在 Apache/Nginx 中看到 PHP 版本没变，那和 phpenv 无关——那是 web server 配置或 php-fpm 实例决定的。
