phpenv真实项目已归档，最稳定镜像为https://gitcode.com/gh_mirrors/ph/phpenv；须用git clone获取源码，再配置PATH与eval "$(phpenv init -)"并重载shell，否则命令不可用。
phpenv 没有官方下载页面或 Windows 安装包，所谓“phpenv 官网”（如 phpenv.cn）不是原始项目维护方，下载需谨慎。 它的主仓库在 GitHub 镜像站，所有可靠安装都基于源码克隆或 installer 脚本，不是点击下载 .exe 或 .dmg。
怎么拿到真实可用的 phpenv 代码
原始项目已归档，当前最稳定可用的是镜像仓库：https://gitcode.com/gh_mirrors/ph/phpenv。GitCode 是国内可直连的 GitHub 镜像，加载快、无 404。
- 推荐用
git clone方式获取，避免 installer 脚本因网络波动失败：git clone https://gitcode.com/gh_mirrors/ph/phpenv ~/.phpenv - 不建议访问
phpenv.cn—— 该域名非项目方所有，其提供的“一键安装器”未被上游验证，可能捆绑额外脚本或修改 PATH 行为 - 如果必须用 installer，只认准原始地址：
curl -L https://raw.githubusercontent.com/phpenv/phpenv-installer/master/bin/phpenv-installer | bash，注意检查raw.githubusercontent.com是否能通（国内有时需代理）
下载后不能直接用：PATH 和 init 是关键两步
克隆完只是把代码放到了 ~/.phpenv，shell 还不认识 phpenv 命令。漏掉这步，运行 phpenv --version 会报 command not found。
- 必须把 bin 目录加入 PATH：
export PATH="$HOME/.phpenv/bin:$PATH"，写入~/.bash_profile或~/.zshrc（根据你用的 shell） - 必须启用 shims 和自动补全：
eval "$(phpenv init -)"，同样要写入 shell 配置文件 - 改完配置别忘了重载：
exec $SHELL -l，而不是新开个终端——否则 shims 不生效，php命令仍指向系统默认版本
为什么 phpenv install 总卡住或报错
下载地址本身没问题，但 phpenv install 实际是去编译 PHP 源码，依赖本地构建环境。失败几乎都和「没装依赖」或「网络无法拉取 php-src 镜像」有关。
立即学习“PHP免费学习笔记（深入）”；
- 常见报错
configure: error: xml2-config not found：缺 libxml2-dev（Ubuntu/Debian）或 libxml2-devel（CentOS/RHEL） - macOS 上用 Homebrew 安装依赖更稳：
brew install autoconf automake libtool pkg-config re2c - 国内用户大概率遇到
curl: (7) Failed to connect to github.com port 443：phpenv 默认从 github.com 下载 PHP 源码包，可手动替换镜像源（比如用 gitee 的 php-src 镜像），或提前下载好 tar.gz 放到~/.phpenv/cache/目录下
真正难的不是“下载”，而是让 phpenv install 8.2.12 跑通。每个系统缺失的依赖不同，错误信息藏在最后几行，别只盯着 “download failed” 看——往上翻，找第一个 error: 才是根因。
