phpEnv通过shell hook动态切换PHP版本，不修改系统PATH；php -v仍显示旧版本或“command not found”，根本原因是eval "$(phpenv init -)"未正确加载到当前shell，导致版本切换机制未激活。
phpEnv 本身不直接配置系统 PATH，它通过 shell hook 动态切换 PHP 版本；直接在命令行运行 php 命令是否生效，取决于 phpenv init 是否已正确加载到当前 shell。
为什么 php -v 仍显示旧版本或报“command not found”
常见错误现象是：明明执行了 phpenv install 8.2.12 和 phpenv global 8.2.12，但新开终端后 php -v 还是老版本，甚至找不到命令。
根本原因不是 phpEnv 没装好，而是它的核心机制没激活——它不改系统 PATH，而是靠 eval "$(phpenv init -)" 注入一个 shell 函数，把 php 命令重定向到当前选中的版本路径。
- 没执行
source ~/.bashrc（或~/.zshrc）：修改配置后未重载，hook 不生效 - 终端用的是 fish / powershell 等非 bash/zsh：phpEnv 默认只支持 bash/zsh，fish 需额外适配
- 用了 VS Code 内置终端但没重启：它可能继承了旧 shell 环境，需完全关闭再开
-
phpenv init -输出为空：说明 phpEnv 安装路径不在$PATH中，phpenv命令本身都不可用
phpenv init - 的输出必须被 eval 才能启用命令拦截
执行 phpenv init - 会输出一段 shell 脚本，类似：
export PATH="/usr/local/phpenv/versions/8.2.12/bin:$PATH" alias phpenv='$(dirname $0)/../libexec/phpenv'
这段脚本的作用是：把当前选中版本的 bin/ 目录插到 $PATH 最前面，并覆盖 php 命令查找顺序。但它不会自动运行，必须显式 eval。
所以你的 ~/.bashrc 或 ~/.zshrc 中必须包含且仅包含这一行（位置建议放在末尾）：
eval "$(phpenv init -)"
- 不能写成
$(phpenv init -)（缺少eval，只是执行并丢弃输出） - 不能把输出内容手动复制粘贴进配置文件（版本切换时不会自动更新）
- 如果用的是 macOS Monterey 及以后默认 zsh，确认改的是
~/.zshrc，不是~/.bash_profile
在命令行直接运行 PHP 脚本时要注意工作目录和版本绑定
phpEnv 切换的是全局或本地（phpenv local）PHP 版本，但命令行运行脚本时，实际调用的 php 解释器完全取决于当前 shell 的 php 命令解析结果，和 Web 服务器无关。
- 用
phpenv local 8.1.26后，在该目录下执行php script.php，就一定走 8.1.26，哪怕phpenv global是 8.2 - 脚本第一行写
#!/usr/bin/env php是安全的，它会尊重当前 shell 的php解析逻辑 - 不要硬编码
#!/usr/local/phpenv/versions/8.2.12/bin/php：失去版本可移植性，且路径在重装后可能失效 - 调试时可用
which php确认当前实际调用路径，比php -v更直观
容易被忽略的关键点：phpEnv 不管理扩展、不修改 php.ini、不处理 Web 服务
很多人以为 phpenv global 之后 Apache/Nginx 就自动跟着切版本，这是错的。phpEnv 只影响 shell 下的 php 命令，对 Web 服务器零影响。
如果你在浏览器里看到的 PHP 版本和 php -v 不一致，说明：
- Web 服务器（如 Apache 的
libphp.so或 Nginx 的 PHP-FPM）用的是另一套独立安装的 PHP -
phpinfo()显示的Loaded Configuration File路径，和php --ini输出的很可能不同 - 想让 Web 服务也用 phpEnv 管理的版本，得手动配置 PHP-FPM 池指向
/usr/local/phpenv/versions/x.y.z/sbin/php-fpm，并确保 socket 权限、用户组匹配
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
