phpenv是专为Linux/macOS设计的PHP版本管理工具，通过PATH路由和shim机制实现多版本切换，依赖php-build插件安装版本，支持global/local/shell三级作用域，不提供Web服务器或数据库。
phpenv 是用来在 Linux/macOS 系统上管理多个 PHP 版本的命令行工具，不是 Windows 上那个带图形界面的 phpEnv（注意大小写和拼写差异）。它不提供 Web 服务器或数据库，只专注一件事：让你能按需切换 PHP 解释器版本。
phpenv 本质是 shell 层的 PATH 路由器
它本身不编译 PHP，也不打包二进制文件，而是通过修改 $PATH 的查找顺序，把 php、composer 等命令指向你指定版本的安装路径。所有版本都装在 ~/.phpenv/versions/ 下，彼此隔离。
- 不改系统全局 PHP，不影响
/usr/bin/php - 不依赖 Docker 或虚拟机，纯 shell + bash/zsh/fish 驱动
- 没有后台进程或服务，执行完命令就退出，零资源占用
- 和
php-build插件配合才能真正安装新版本（否则phpenv install会报错）
三种版本作用域必须分清
同一台机器上可以同时存在全局、项目级、会话级三种设置，优先级从高到低：
-
phpenv shell 8.2.12：仅当前终端生效，关掉就失效 -
phpenv local 7.4.33：在当前目录生成.php-version文件，cd 进来自动触发切换 -
phpenv global 8.3.13：写入~/.phpenv/version，作为所有未指定项目的兜底版本
注意：phpenv local 写的不是绝对路径，是版本号字符串；如果该版本未安装，php 命令会直接报 command not found，不会 fallback 到 global。
立即学习“PHP免费学习笔记（深入）”；
常见错误：phpenv version 显示 “system” 却找不到 php
这通常是因为：
- 没运行
eval "$(phpenv init -)"，导致 shell 没加载 phpenv 的 shim 机制 -
phpenv root输出的路径下没有shims/目录，说明初始化失败 - 你用的是 fish shell 但只配置了 bash 补全脚本，shim 不生效
-
which php返回/usr/bin/php，说明 phpenv 的shims根本没进$PATH
验证是否生效最简单的办法：phpenv which php 应该输出类似 ~/.phpenv/versions/8.3.13/bin/php；如果输出 system，说明当前没走 phpenv 路由。
phpenv 和 php-build 插件的关系
phpenv 自身不能安装 PHP，它只管“选哪个”，不管“哪来的”。真正下载、编译、安装 PHP 的是插件 php-build：
- 必须手动克隆到
$(phpenv root)/plugins/php-build -
phpenv install --list能看到可用版本，但列表来自php-build内置清单 - 编译时默认启用
--enable-opcache，但不自动装ext-mbstring或ext-curl，需要加--configure-options - 国内用户常因 GitHub raw URL 被限速而卡在下载
php.tar.gz，可提前下载好并用--define archive=/path/to/php-8.3.13.tar.gz指定本地包
真正麻烦的从来不是切换版本，而是让某个老项目依赖的 PHP 5.6.40 在现代 glibc 环境下编译通过——那得自己补 patch，phpenv 不负责这个。
