phpenv官方源码已归档，当前稳定镜像地址是https://gitcode.com/gh_mirrors/ph/phpenv；需用git clone克隆至~/.phpenv，不可下载Windows版PHPEnv.exe或依赖Homebrew安装。
phpenv 不是 Windows 上那个带图形界面的“PHPEnv”集成包，也不是 XAMPP 或 WAMP。它是类 Unix 系统（macOS / Linux）上用 Shell 写的、类似 rbenv 或 pyenv 的 PHP 版本管理工具——纯命令行，无 GUI，不打包 Apache/MySQL。
phpenv 官方源码在哪找？别下错成 Windows 软件
官方仓库已归档，当前稳定可用的镜像地址是：https://gitcode.com/gh_mirrors/ph/phpenv。注意：这不是官网下载页，也没有 exe 安装包；它是一个 Git 仓库，必须用 git clone 获取。
常见错误现象：
- 搜“phpenv 下载”点进某些中文博客，结果下到一个叫
PHPEnv.exe的 Windows 集成环境 —— 那是完全不同的东西，和phpenv无关 - 用
brew install phpenv失败 —— Homebrew 官方源里没有这个 formula，得手动安装
正确做法：
立即学习“PHP免费学习笔记（深入）”；
- 确保已安装
git和curl - 运行：
git clone https://gitcode.com/gh_mirrors/ph/phpenv ~/.phpenv - 别克隆到
/tmp或桌面，必须是~/.phpenv（否则后续init会找不到路径）
装完 phpenv 后为什么 php -v 还是旧版本？shims 没生效
phpenv 本身不提供 PHP 二进制，它只接管 PATH 并通过“shim”机制把 php、composer 等命令代理到当前激活的版本。没生效 = shell 初始化没跑对。
关键步骤：
- 向
~/.profile（或~/.zshrc，取决于你用的 shell）追加两行：export PATH="$HOME/.phpenv/bin:$PATH"eval "$(phpenv init -)" - 执行
exec $SHELL -l重载配置（不是source ~/.zshrc，后者不触发 login shell 初始化） - 验证：
which php应该输出~/.phpenv/shims/php，而不是/usr/bin/php
容易踩的坑：
- 改了
.zshrc却用bash启动终端 → 不生效 - 漏掉
eval "$(phpenv init -)"→phpenv versions能列出来，但php命令仍调用系统默认版本
phpenv local / global / shell 切换失效？php-build 插件没装
phpenv install 命令根本不存在 —— 这是 php-build 插件提供的功能。没装插件时，phpenv install 8.3.13 会报 command not found。
必须手动安装插件：
- 运行：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 确认插件路径是
~/.phpenv/plugins/php-build（不是~/.phpenv/plugin/...，少个 s 就失败） - 装完后执行
phpenv install --list才能看到可选版本
版本切换逻辑：
-
phpenv global 8.3.13→ 写入~/.phpenv/version，影响所有目录 -
phpenv local 7.4.33→ 在当前目录生成.php-version，优先级高于 global -
phpenv shell 5.6.40→ 设置临时环境变量PHPENV_VERSION，仅当前终端有效
注意：phpenv shell 设置后，新开一个终端就失效，且不能和 local 共存（shell 会覆盖 local）。
编译 PHP 失败：configure: error: no acceptable C compiler found
Linux/macOS 下用 phpenv install 编译 PHP，本质是跑 ./configure && make && make install。缺编译器或依赖库，直接中断。
典型报错：
-
configure: error: no acceptable C compiler found in $PATH→ 没装 GCC（Ubuntu/Debian：运行sudo apt install build-essential；CentOS/RHEL：sudo yum groupinstall "Development Tools"） -
configure: error: xml2-config not found→ 缺 libxml2-dev（Ubuntu：sudo apt install libxml2-dev） -
configure: error: Cannot find OpenSSL's <evp.h>→ 缺 openssl-devel（CentOS：sudo yum install openssl-devel）
建议提前装全依赖再试：
- Ubuntu/Debian：
sudo apt install build-essential autoconf automake bison re2c libxml2-dev libssl-dev libsqlite3-dev libcurl4-openssl-dev libpng-dev libjpeg-dev libfreetype6-dev - macOS：
brew install autoconf automake openssl@3 sqlite3 curl libpng jpeg freetype，并确保export PATH="/opt/homebrew/opt/openssl@3/bin:$PATH"已设好
最后提醒一句：Windows 用户如果真想用 phpenv，得开 WSL2；原生 cmd/PowerShell 下它根本不工作 —— 这点文档里常被忽略，但实际卡住很多人。
