phpenv是主流PHP版本管理工具，专注命令行切换PHP版本，需git克隆安装、配置PATH和init，依赖autoconf等编译工具，通过global/local命令切换版本并生成.php-version文件。
phpEnv 不是官方 PHP 组织发布的工具，目前主流且可稳定使用的其实是 phpenv（小写 p、h、p、e、n、v），一个类 rbenv/pyenv 的开源 PHP 版本管理器。它不打包 Apache 或 MySQL，只专注 PHP 解释器的安装与切换——这点和名字带大写 E 的 Windows 图形化工具 PHPEnv（已多年未更新）完全不同，别下错。
怎么确认你要的是 phpenv 而不是 PHPEnv
如果你在找「命令行切换 PHP 7.4/8.1/8.3」、「配合 CI 流水线指定版本」、「项目级 .php-version 文件生效」这类能力，那你需要的是 phpenv。它基于 Shell shim 机制，轻量、可脚本化、Linux/macOS 原生支持好。
如果你实际想要的是「一键启动 Apache+MySQL+PHP 控制面板」，那应该用 XAMPP、Laragon 或老牌但已停更的 PHPEnv for Windows（官网域名失效，GitHub 最后更新是 2020 年）。这类工具现在基本被 Docker 或 Laravel Valet 取代。
- 查当前有没有装错：运行
which phpenv，如果返回空，说明没装；如果返回/c/Users/xxx/AppData/Roaming/composer/vendor/bin/phpenv这类路径，大概率是 Composer 包冲突，得删掉 - Windows 用户注意：
phpenv原生不支持 cmd/PowerShell，必须用 WSL2 或 Git Bash；直接双击 exe 安装的“PHPEnv”不是这个 - macOS 上 Homebrew 有
phpenv公式，但维护滞后，建议直接 git clone 官方镜像
phpenv 安装四步走（实测可用）
以下以 macOS/Linux 为例，使用官方推荐方式（非 installer 脚本，避免权限和路径陷阱）：
- 克隆代码到标准位置：
git clone https://gitcode.com/gh_mirrors/ph/phpenv ~/.phpenv - 追加两行到你的 shell 配置（
~/.bashrc或~/.zshrc）：export PATH="$HOME/.phpenv/bin:$PATH"eval "$(phpenv init -)" - 重载配置：
source ~/.zshrc（Zsh）或source ~/.bashrc（Bash） - 验证：
phpenv --version应输出类似phpenv 1.2.5；phpenv versions应显示no versions installed（正常，还没装 PHP）
常见失败点：phpenv init - 报 command not found → 检查 $PATH 是否漏了 $HOME/.phpenv/bin；phpenv install 报 missing autoconf → 先 brew install autoconf automake libtool（macOS）或 sudo apt install autoconf automake libtool-bin（Ubuntu）
phpenv install 报错最常见的三个原因
phpenv install 不是下载预编译包，而是从源码编译 PHP，所以依赖多、耗时长、容易卡在中间。别急着重试，先看报错关键词：
-
configure: error: xml2-config not found→ 缺 libxml2 开发头文件，macOS 执行brew install libxml2，Ubuntu 执行sudo apt install libxml2-dev -
fatal error: openssl/ssl.h: No such file or directory→ OpenSSL 头文件缺失，macOS：brew install openssl，然后设环境变量：export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=$(brew --prefix openssl)" - 卡在
checking for re2c...→re2c工具没装，brew install re2c（macOS）或sudo apt install re2c（Ubuntu）
每次改完依赖都要执行 phpenv rehash，否则新装的 PHP 版本不会出现在 phpenv versions 列表里。
装完 PHP 后 php 命令还是旧版本？
这是最常被忽略的一环：shell 的 php 命令默认指向系统自带 PHP（比如 macOS 的 /usr/bin/php），而 phpenv 是靠 shims 劫持调用的。必须显式启用版本：
- 设全局默认：
phpenv global 8.3.13 - 进项目目录设局部：
cd my-project && phpenv local 7.4.33（会自动生成.php-version文件） - 检查是否生效：
which php应返回~/.phpenv/shims/php，php -v显示对应版本
如果 which php 仍是系统路径，说明 eval "$(phpenv init -)" 没生效，或者你开了新终端但没重新 source 配置文件。别跳过这一步，否则前面全白忙。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
