phpenv是专为CLI设计的PHP版本管理工具，通过shims机制动态切换php命令路径，依赖shell>local>global三级作用域（由.php-version文件和phpenv version命令识别），不干预Web服务；安装需先配置php-build插件及系统编译依赖，切换后须执行phpenv rehash并确保~/.phpenv/shims在PATH最前。
phpenv 是专为 CLI 环境设计的 PHP 版本管理工具，它不启动服务、不干预 Web 请求，只通过 shims 机制动态切换终端中 php 命令指向的具体二进制路径。不同项目用不同 PHP 版本，核心靠的是“作用域优先级”和“目录感知”，而非全局替换或后台多进程运行。
项目级自动切换：靠 .php-version 文件
这是最常用也最可靠的隔离方式。进入项目根目录后执行：
-
phpenv local 7.4.33—— 会在当前目录生成.php-version文件，内容仅为7.4.33 - 该文件必须放在项目最外层目录，不能有空格、注释或多行
- 下次
cd进入此目录时，php -v自动显示 7.4.33；进入其他目录则按规则回退 - 若版本未生效，先运行
which php看是否指向~/.phpenv/shims/php，再检查echo $PATH是否含~/.phpenv/shims且位置靠前
全局默认与临时会话：分层兜底策略
当没有本地文件锁定时，phpenv 按固定顺序决定用哪个版本：
-
phpenv global 8.3.13→ 写入~/.phpenv/version，作为所有未声明项目的默认值 -
phpenv shell 5.6.40→ 仅当前终端有效，关闭即恢复，适合快速验证兼容性 - 三者优先级为：shell > local > global，不会冲突，而是自然覆盖
- 查看当前实际生效版本：始终用
phpenv version（不是php -v），它明确告诉你“此刻被选中的是哪一个”
安装新版本：先装插件，再补依赖
phpenv 本身不带编译能力，phpenv install 命令来自 php-build 插件：
立即学习“PHP免费学习笔记（深入）”；
- 手动安装插件：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - Ubuntu/Debian 必装依赖：
sudo apt install build-essential autoconf bison libxml2-dev libssl-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev libicu-dev libzip-dev - macOS（Homebrew）需导出路径：
export PATH="/opt/homebrew/opt/bison/bin:$PATH"，并安装openssl@3、icu4c等 - 安装完成后务必运行
phpenv rehash，否则新版本不会出现在phpenv versions列表中
Web 服务完全不受影响：Nginx/Apache 需单独配置
phpenv 对网页请求零作用——Nginx 不读 .php-version，也不看你的 shell 环境变量。要让不同站点跑不同 PHP 版本，必须：
- 为每个 PHP 版本配独立
php-fpm实例，监听不同 socket（如/run/php/php7.4-fpm.sock）或端口（如127.0.0.1:9001） - 在对应站点的 Nginx
server块中显式写：fastcgi_pass unix:/run/php/php7.4-fpm.sock; - 确保
php-fpm进程确实在运行：ps aux | grep 'php-fpm.*7\.4' - 修改后执行：
nginx -t && systemctl reload nginx，不是 restart
CLI 和 Web 是两套独立体系：phpenv 管命令行，FPM + Web 服务器管网页。混淆二者是绝大多数 502 或版本错乱的根本原因。
