phpenv无官方下载站，唯一可信源是GitCode镜像https://gitcode.com/gh_mirrors/ph/phpenv；安装需满足编译依赖、正确配置shell、启用扩展参数，版本切换依赖global/local/shell三类指令及对应文件或环境。
phpenv 没有官方下载地址，只有源码仓库
phpenv 不是打包发布的桌面软件，也没有官网或 phpenv.cn 这类独立域名的“官方下载站”。你看到的 http://www.phpenv.cn 是 2018 年一个第三方镜像站，早已失效且与当前维护的 phpenv 项目无关。目前唯一可信来源是 GitHub 镜像仓库：https://gitcode.com/gh_mirrors/ph/phpenv（GitCode 托管的稳定镜像），主项目已迁至 https://github.com/phpenv/phpenv，但近期更新均同步至此镜像。
安装失败最常见的三个原因
不是命令写错，而是环境没对齐。以下三点不满足，phpenv install 必报错：
-
curl、git、make、autoconf、gcc、libxml2-dev（Linux）或libxml2（macOS）等编译依赖未安装 - Shell 配置文件（如
~/.bashrc或~/.zshrc）里漏了eval "$(phpenv init -)"，导致phpenv命令能运行，但php命令仍调用系统自带版本 - 执行
source ~/.bashrc后没验证which php是否指向~/.phpenv/shims/php—— 如果还是/usr/bin/php，说明 shims 机制根本没生效
phpenv install 安装 PHP 版本时必须加的参数
phpenv install 默认只装最小化 PHP，不带常用扩展（比如 pdo_mysql、openssl、curl），直接跑 Laravel 或 WordPress 会报扩展缺失。解决办法是用 --enable-option-checking=fatal + 环境变量预设：
例如安装 8.3.13 并启用 MySQL 和 OpenSSL：
立即学习“PHP免费学习笔记（深入）”；
CONFIGURE_OPTS="--with-pdo-mysql --with-openssl" phpenv install 8.3.13
注意：CONFIGURE_OPTS 必须放在 phpenv install 命令前，顺序错了就无效；不同 Linux 发行版的库包名不同（Ubuntu 叫 libmysqlclient-dev，CentOS 叫 mysql-devel），装之前先 apt search mysql | grep dev 或 yum search mysql | grep devel 确认。
local / global / shell 三种版本切换的实际效果差异
很多人以为 phpenv local 就是“进目录自动切”，其实它只在当前目录及子目录生效，且依赖 .php-version 文件内容。真正容易被忽略的是：
-
phpenv global 8.3.13：修改~/.phpenv/version，影响所有新打开的终端，但不会覆盖已有终端里的phpenv shell设置 -
phpenv local 7.4.33：在当前目录生成.php-version，内容就是7.4.33—— 如果你用 IDE 终端或 VS Code 内置终端，需重启终端才能读取新文件 -
phpenv shell 8.0.1：只在当前 shell 会话生效，退出即失效，适合临时测试，但 CI 脚本里慎用，因为 shell 生命周期不可控
最稳的做法是：全局设一个兜底版本（如 8.3），项目根目录放 .php-version，再配个 .phpenv-hooks 自动重载 shims —— 否则改完 .php-version 后还得手动跑一次 phpenv rehash。
