phpenv切换CLI版本后php -v仍显示旧版本，根本原因是PATH未优先加载~/.phpenv/shims，或存在系统硬链接/别名干扰；需执行phpenv rehash、确认初始化脚本正确加载且位于PATH前，并检查.local/.shell版本覆盖。
phpenv 切换 CLI 版本后 php -v 仍显示旧版本
根本原因是系统 PATH 中存在硬链接或别名干扰，比如 /usr/bin/php 或 shell 别名覆盖了 phpenv 的 shims。phpenv 本身不修改全局 PHP 二进制，只通过 ~/.phpenv/shims 目录注入可执行文件，并依赖 PATH 优先级生效。
检查当前生效的 php 路径：
which php<br>ls -l $(which php)
- 如果输出是
/usr/bin/php或指向系统包管理器安装的路径（如/usr/lib/php*/bin/php），说明 phpenv 的 shim 没被加载 - 运行
phpenv rehash确保所有已安装版本的 shim 已生成 - 确认 shell 初始化脚本（如
~/.bashrc或~/.zshrc）中包含且**位于 PATH 修改之前**的 phpenv 初始化段：export PATH="$HOME/.phpenv/bin:$PATH"<br>eval "$(phpenv init -)"
- 重载配置后，再执行
phpenv global 8.2.12，然后验证which php应返回~/.phpenv/shims/php
phpenv global 和 shell 本地版本不一致
phpenv 支持三级版本控制：global（全局）、shell（当前终端会话）、local（当前目录 .php-version 文件）。CLI 下最常踩的坑是 local 配置残留导致意外切换。
- 检查当前目录是否存在
.php-version文件：cat .php-version，它会强制覆盖 global 设置 - 清除 local 设置：
phpenv local --unset；清除 shell 级设置：phpenv shell --unset - 注意：shell 级设置（
phpenv shell 8.1.27）只在当前终端有效，新开终端不继承；而 global 是持久化的默认值 - 若在项目根目录执行过
phpenv local 7.4.33，即使退出该目录，只要未执行phpenv shell --unset，新终端仍可能沿用上一次 shell 设置（取决于是否启用 auto-rehash 或插件缓存）
Composer 执行时 PHP 版本与预期不符
Composer 本身是 PHP 脚本，其运行依赖于启动它的 PHP 解释器。即使 php -v 正确，Composer 可能被 shebang（#!/usr/bin/env php）调用到错误版本。
立即学习“PHP免费学习笔记（深入）”；
- 检查 Composer 的 shebang 行：
head -1 $(which composer)—— 若为#!/usr/bin/env php，则它完全受当前php命令影响，无需额外配置 - 但若为硬编码路径（如
#!/usr/bin/php），就绕过了 phpenv；此时应重装 Composer：curl -sS https://getcomposer.org/installer | php -- --install-dir=$HOME/bin --filename=composer
，确保使用env php启动方式 - 验证方式：运行
composer --version后立即执行php -r "echo PHP_VERSION;"，两者版本号必须一致
PHP CLI 与 Web Server（如 Apache + mod_php）版本混用
phpenv **只管理 CLI 版本**，对 Web SAPI 完全无影响。Apache 的 libphp.so 或 Nginx 的 php-fpm 进程由系统服务配置决定，和 phpenv 无关。
常见误判场景：在终端切到 PHP 8.2，浏览器访问 phpinfo() 却显示 7.4 —— 这不是 phpenv 失效，而是 Web 服务器没重启或没切换 fpm pool。
- 确认 Web 使用的 PHP SAPI：
phpinfo()页面中查看 “Server API” 字段（应为 “Apache 2.0 Handler” 或 “FPM/FastCGI”） - 如果是 php-fpm，需手动切换并重启服务：
sudo systemctl stop php7.4-fpm<br>sudo systemctl start php8.2-fpm
- Apache 用户注意：
libphp模块是编译绑定的，不能靠 phpenv 切换；必须用a2dismod php7.4 && a2enmod php8.2并重启 httpd
真正容易被忽略的是：phpenv 对 php-cgi、php-config、phpize 等配套工具也做 shim 管理，但扩展编译（如 pecl install）若调用系统 phpize，会导致头文件路径错配 —— 务必用 $(phpenv which phpize) 显式指定路径。
