phpenv是类unix系统下基于shell的轻量级php版本管理工具，通过shims和环境变量劫持实现多版本切换，需git、编译工具及php-build插件支持，不适用于windows图形界面套件。
phpenv 不是 Windows 上那个带图形界面的「PHPEnv」集成包，也不是官网 phpenv.cn 提供的一键安装器。它是类 Unix 系统（macOS / Linux）下基于 Shell 的轻量级 PHP 版本管理工具，靠 shims 和环境变量劫持命令路径来实现多版本切换。
如果你在 Windows 上双击安装了「phpEnv」并看到 Apache 控制面板、MySQL 图标、网站管理界面——那根本不是 phpenv，而是国产封装套件（常被误称为 phpEnv），它和 phpenv 没有代码或设计上的关系。两者连作者、仓库、原理都完全不同。
下面只讲真实、可验证、开源社区通用的 phpenv 安装过程。
确认系统环境与依赖是否齐备
在终端里运行以下命令检查基础条件：
-
git --version：必须已安装 Git（用于克隆源码） -
curl --version或wget --version：下载 PHP 源码时要用到 -
make、gcc、autoconf、openssl-devel（CentOS/RHEL）或libssl-dev（Debian/Ubuntu）：编译 PHP 所需的构建工具和头文件 - 注意：
phpenv本身不提供预编译二进制，所有phpenv install命令都会从源码编译安装，所以系统必须能编译 C 项目
克隆 + 初始化三步到位
别用 sudo，所有操作都在用户目录下完成：
- 执行
git clone https://gitcode.com/gh_mirrors/ph/phpenv ~/.phpenv - 根据你的 Shell 类型（
bash还是zsh），把这两行加到对应配置文件末尾（如~/.bashrc或~/.zshrc）：export PATH="$HOME/.phpenv/bin:$PATH"eval "$(phpenv init -)" - 重载配置：
source ~/.bashrc（或source ~/.zshrc） - 验证：
phpenv --version应输出类似phpenv 1.2.6
安装 php-build 插件才能用 phpenv install
phpenv install 命令默认不可用，它依赖外部插件 php-build。没装这个，你只能手动编译 PHP 或用 phpenv global 切换已存在的系统 PHP。
- 运行：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 装完后执行
phpenv install --list就能看到可安装的版本号（如8.3.13、7.4.33） - 安装某个版本：
phpenv install 8.3.13（耗时较长，可能 5–20 分钟，取决于机器性能） - 注意：首次安装失败大概率是缺系统依赖（比如没装
libxml2-dev），错误信息里会明确提示缺失的.h文件名，按提示apt install或yum install即可
版本生效逻辑和 .php-version 文件优先级
phpenv 查找 PHP 版本的顺序是固定的，且不读取任何 GUI 配置或注册表：
- 先查当前 Shell 会话是否设置了
phpenv shell（最高优先级） - 再查当前目录是否存在
.php-version文件（项目级，内容就一行，如8.3.13） - 最后回落到
phpenv global设置的全局版本 - 执行
phpenv local 8.3.13就会在当前目录生成.php-version，这个文件应纳入 Git 提交，确保团队一致 - 切记：
phpenv global改的是~/.phpenv/version，不是系统/usr/bin/php，不影响其他用户或系统服务
php -v 看到的版本，完全取决于当前 Shell 环境中 which php 输出的路径是否落在 ~/.phpenv/shims/php 下——而这个 shims 目录只有在 eval "$(phpenv init -)" 成功加载后才起作用。如果忘了 source 配置、或者新开终端没 reload，php 命令就还是系统自带的那个。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
