phpenv local 未生效是因为 shims 未刷新或 PATH 中其他 PHP 优先级更高；需运行 phpenv rehash、确认 .php-version 文件存在且内容正确、检查 which php 是否指向 ~/.phpenv/shims/php，并确保 shell 配置已加载。
phpenv local 命令为什么没生效
执行 phpenv local 8.2.20 后，php -v 仍显示旧版本，大概率是 shims 没刷新或当前 shell 未识别到本地设置。
常见原因和操作建议：
-
phpenv rehash必须在安装或切换后手动运行——它会重建所有版本的可执行文件软链接（shims），否则php命令仍指向旧路径 - 确认当前目录下生成了
.php-version文件（内容为8.2.20），没有该文件说明命令未写入成功 - 检查
which php输出是否为~/.phpenv/shims/php；如果不是，说明系统 PATH 中有其他 PHP（如系统自带、Homebrew 或 XAMPP 的）优先级更高 - 如果用的是 zsh，确保配置写入的是
~/.zshrc而非~/.bashrc，且已执行source ~/.zshrc
多个项目各自绑定不同 PHP 版本的正确姿势
每个项目根目录独立使用 phpenv local，不是靠“站点”概念自动识别，而是依赖目录层级和 .php-version 文件位置。
实操要点：
立即学习“PHP免费学习笔记（深入）”；
- 进入项目 A 目录：
cd /var/www/site-a→ 运行phpenv local 7.4.33→ 自动生成.php-version - 进入项目 B 目录：
cd /var/www/site-b→ 运行phpenv local 8.3.13→ 生成另一个.php-version - 只要不跨目录执行命令，
php就会自动按当前目录的.php-version切换；无需全局配置或 Web 服务器干预 - Web 服务（如 Nginx + PHP-FPM）不受 phpenv 影响——它调用的是 FPM 进程，不是 CLI 的
php。要让站点用不同 PHP，得配不同 FPM socket 或端口，这和 phpenv 无关
phpenv global 和 local 冲突时谁优先
local 永远高于 global，但前提是当前 shell 工作目录下存在有效的 .php-version 文件。
判断逻辑是：phpenv 启动时从当前路径向上逐级查找 .php-version，找到第一个即生效；找不到才回落到 global 设置。
容易踩的坑：
- 在子目录（如
/var/www/site-a/public）执行phpenv local，会导致该子目录下生效，但上层site-a目录不生效——应始终在项目根目录操作 -
phpenv shell 8.1.27会覆盖 local 和 global，仅对当前终端会话有效；关掉终端就失效，适合临时测试 - 如果
.php-version文件内容写错（如多空格、带换行符、版本号不存在），phpenv 会静默忽略，退回到 global
PHP-FPM 和 phpenv 完全不兼容，别混用
phpenv 只管理 CLI 环境下的 php 命令，对 Web 请求无任何作用。Nginx/Apache 调用的 PHP 是由 PHP-FPM 或 mod_php 提供的独立进程，它们有自己的二进制路径和配置。
如果你希望不同站点跑不同 PHP 版本，必须：
- 为每个 PHP 版本单独编译并启动一个 PHP-FPM 实例（如
php-fpm-74监听127.0.0.1:9074，php-fpm-83监听127.0.0.1:9083） - 在 Nginx server block 中分别配置
fastcgi_pass指向对应端口或 socket - phpenv 对这个过程零参与——它甚至不知道你在跑 Web 服务
混淆这两层是新手最常卡住的地方：以为 phpenv local 能让浏览器访问的 PHP 页面也切换版本，其实不能。
