根本原因是phpenv二进制未加入$path，需检查~/.phpenv/bin/phpenv是否存在，添加export path="$home/.phpenv/bin:$path"到shell配置并source；再执行eval "$(phpenv init -)"启用shim机制，否则php命令无法路由到指定版本。
phpenv install 报 command not found 怎么办
根本原因是 phpenv 二进制没进 $PATH，shell 找不到命令。不是没装成功，而是路径没生效。
检查 ~/.phpenv/bin/phpenv 是否存在；如果存在，就往 shell 配置里加这行：
export PATH="$HOME/.phpenv/bin:$PATH"
然后执行：source ~/.bashrc（或 ~/.zshrc，看你的 shell 类型）。别漏掉 eval "$(phpenv init -)" 这句，它负责生成 shim —— 否则即使 PATH 对了，php 命令还是调不到你装的版本。
装完 PHP 版本却切不了：global/local 不生效
常见错觉是“装完了就能切”，其实 phpenv install 只是把二进制放进去，phpenv global 8.2 这类命令依赖 shim 文件才能路由到对应版本。
必须立刻执行：phpenv rehash
这个命令会扫描 ~/.phpenv/versions/ 下所有已安装版本，在 ~/.phpenv/shims/ 里生成 php、phpize、composer 等可执行文件。没它，phpenv 就是空壳。
验证是否生效：which php 应该输出 ~/.phpenv/shims/php，再 php -v 看版本。
phpenv 启动时报 “Permission denied” 或 “No such file or directory”
这类报错往往不是 PHP 本身的问题，而是编译时缺失依赖，导致生成的二进制无法运行。典型表现是：phpenv install 8.2 显示 success，但一执行 php -v 就挂。
先看日志：tail -n 50 ~/.phpenv/plugins/php-build/share/php-build/log/8.2.log
高频缺失项（Ubuntu/Debian）：libxml2-dev、libssl-dev、libcurl4-openssl-dev、libjpeg-dev、libpng-dev、libfreetype6-dev
CentOS/RHEL 系统对应为：libxml2-devel、openssl-devel、libcurl-devel、libjpeg-devel、libpng-devel、freetype-devel
装完依赖后，不要重试 phpenv install —— 先删掉失败的安装目录：rm -rf ~/.phpenv/versions/8.2，再重装。
CLI 和 web 页面显示不同 PHP 版本
这是最常被当成「phpenv 失效」的问题，其实和 phpenv 完全无关。phpenv 只管 CLI，FPM 是另一套独立进程，由 Nginx/Apache 的 fastcgi_pass 或模块配置决定。
确认 CLI 版本：php -v
确认 Web 版本：建一个 info.php，内容为 <?php phpinfo(); ?>，浏览器访问，重点看「Loaded Configuration File」和「PHP Version」两栏。
两者不一致？说明 FPM 没配对。比如你用 phpenv 切到 8.2，但 Nginx 仍连着 127.0.0.1:9000（可能是系统默认 PHP-FPM），就得去 Nginx 配置里把 fastcgi_pass 改成指向 phpenv 编译出的 FPM 实例（通常在 ~/.phpenv/versions/8.2/sbin/php-fpm，需手动启停并监听 TCP 端口）。
注意：phpenv 默认不启动 FPM，也不改 Nginx 配置 —— 它只解决命令行环境。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
