phpenv通过shims机制动态路由php命令，而非修改软链接或重装php；若php -v未变，需检查是否已安装目标版本、shims是否激活（eval "$(phpenv init -)"已生效）、.php-version文件内容是否正确（如8.3.13，无空格引号）。
phpenv 切换 PHP 版本不是改软链接或重装 PHP，而是靠 shims 机制动态路由命令调用——只要正确安装版本并设置作用域，php 命令就会自动指向目标版本。
为什么 php -v 没变？检查三个关键状态
常见现象：执行了 phpenv local 8.3.13，但 php -v 仍显示旧版本。这不是命令失效，而是环境未就位：
- 没装对应版本：
phpenv install 8.3.13必须先成功运行（需php-build插件）； - 没激活 shims：
eval "$(phpenv init -)"必须写入 shell 配置并重载（source ~/.zshrc或exec $SHELL -l）； - 当前目录无
.php-version文件或文件内容错误（如多空格、带引号、换行符异常）。
phpenv local 在项目根目录生效的细节
这个命令本质是往当前目录写一个纯文本文件 .php-version，内容就是版本号（例如 8.3.13），不带空格、不带 php- 前缀。进入该目录时，phpenv 通过 shell hook 自动读取并激活对应 shims。
- 它只影响当前目录及所有子目录，父目录或同级其他项目完全不受干扰；
- 若子目录里有另一个
.php-version，会覆盖上级设置（即就近原则）； - 删除该文件或执行
phpenv local --unset即可恢复上层作用域（通常是 global）； - 注意：Git 默认不跟踪
.php-version，建议手动git add .php-version纳入版本控制，确保协作者环境一致。
phpenv global 和 phpenv shell 的实际差异
三者优先级是：shell > local > global。但它们的生命周期和影响范围完全不同：
-
phpenv global 7.4.33：写入~/.phpenv/version，对所有新终端、所有目录生效，除非被 local 或 shell 覆盖； -
phpenv shell 8.2.0：只在当前终端会话有效，关闭窗口即失效，适合临时验证兼容性； -
phpenv local 8.3.13：写入当前目录.php-version，持久化且项目级隔离，是日常开发最推荐的方式。
误用 global 当作项目配置，会导致切换混乱——尤其当你同时打开多个终端处理不同项目时。
切换后 composer 或 phpunit 还用旧版本？
因为 composer 和 phpunit 是独立二进制，它们本身不走 phpenv 的 shims 路由。真正起作用的是它们内部调用的 php 解释器：
- 确认
which php返回的是~/.phpenv/shims/php（不是/usr/bin/php）； - 如果
composer是 Phar 包，它会使用当前php命令启动，所以只要 shims 正常，Composer 就用对版本； - 某些 IDE（如 PhpStorm）会缓存 PHP 解释器路径，需手动刷新或重启 IDE 才能识别新版本；
- CI 环境中务必在每步命令前加
phpenv global x.y.z或phpenv local x.y.z，不能依赖初始化脚本的默认值。
最容易被忽略的一点：phpenv 不修改系统级 php-fpm 或 Web 服务器配置——它只管 CLI。Web 请求的 PHP 版本由 Nginx/Apache + PHP-FPM 实例决定，和 phpenv 完全无关。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
