phpenv install 不提供全版本下载包，而是实时编译；版本列表来自 php-build 插件的静态 definition 文件；安装失败多因依赖缺失、网络问题或 definition 过期；离线安装需手动缓存源码并软链；安装后必须执行 phpenv rehash。
phpenv install 命令本身不提供“全版本下载包”，它每次都是从源码实时编译安装——所以不存在“一键下载全部版本”的操作，强行批量安装既耗时又无必要。
phpenv install --list 显示的版本从哪来？
执行 phpenv install --list 时，列表数据来自 php-build 插件内置的定义文件（$(phpenv root)/plugins/php-build/share/php-build/ 下的 definitions/ 目录），这些定义是静态 JSON 文件，描述了每个 PHP 版本的下载地址、校验和、依赖配置等。
- 官方发布页（https://www.php.cn/link/ee617a1f3bbdbbbc0996f12fca2a3701）上的所有稳定版、RC 版、旧 LTS 版都会被收录进 definitions
- 部分已归档或 EOL 的老版本（如 5.3.x、5.4.x）仍保留在 definitions 中，但源码链接可能失效——遇到
curl: (22) The requested URL returned error: 404就是这个原因 - 列表里带
-debug或-zts后缀的不是独立版本，而是编译变体，需手动改 definition 文件或传参指定
为什么 phpenv install 7.4.33 失败？常见断点在哪
失败通常卡在三个环节：依赖缺失、网络中断、definition 过期。不是版本“没提供”，而是环境没准备好。
- Linux 系统必须预装编译工具链：
build-essential（Debian/Ubuntu）或Development Tools（CentOS/RHEL） - 缺少关键库会导致 configure 阶段报错，例如：
configure: error: openssl/ssl.h: No such file or directory→ 补libssl-dev（Debian）或openssl-devel（RHEL） - 国内直连 php.net 源码慢或超时，可临时设镜像：
PHP_BUILD_MIRROR=https://mirrors.tuna.tsinghua.edu.cn/php/distributions/ phpenv install 8.2.12 - 某些老版本（如 5.6.40）的 definition 中 SHA256 校验值已过时，需手动编辑对应 definition 文件修正
想“离线安装”多个 PHP 版本？得自己搭缓存
phpenv 本身不支持离线包管理，但你可以用 php-build 手动预拉取源码并复用：
立即学习“PHP免费学习笔记（深入）”；
- 先用
phpenv install -v 8.1.27（加-v看完整日志），记下它下载的 tar.gz URL - 用
wget下载到本地，比如存到~/php-src-cache/php-8.1.27.tar.gz - 创建软链覆盖默认下载路径：
ln -sf ~/php-src-cache/php-8.1.27.tar.gz $(phpenv root)/plugins/php-build/cache/ - 再运行
phpenv install 8.1.27，它会跳过下载直接解压编译 - 注意：每个版本要单独缓存，且 tar.gz 名称必须与 definition 中声明的完全一致（含大小写、点号）
phpenv versions 不显示刚 install 的版本？立刻 run rehash
这是最常被忽略的一步。phpenv 用 shim 机制拦截 php、phpize 等命令，新版本装完后，shim 文件不会自动更新。
- 必须手动执行
phpenv rehash，否则php -v仍显示旧版本，phpenv versions也不列出来 - 如果用了
phpenv plugin install php-build，某些旧版插件可能不触发自动 rehash，不能依赖“安装完就可用” - 建议养成习惯：每次
phpenv install后紧跟phpenv rehash，尤其在 CI 脚本或 Docker 构建中
真正麻烦的从来不是“怎么装多个版本”，而是编译参数不一致导致扩展 ABI 不兼容——比如你用 --enable-opcache 装了 8.2.10，却用默认参数装了 8.2.11，两个版本的 opcache.so 就不能混用。这点比版本数量重要得多。
