phpenv 不提供预编译多版本集成包，仅支持源码构建：推荐用 phpenv-installer 一键安装（含 php-build 插件），或手动安装后补插件；安装后须执行 phpenv rehash 并验证 which php 指向 shims。
phpenv 不提供“多版本集成包”——它本身就是一个轻量级的版本管理工具，所有 PHP 版本都按需单独编译安装，不存在预打包的“集成版”。直接下载一个压缩包就能切换多个 PHP 版本？那是误解。
phpenv 安装方式只有两种，别被“集成包”带偏
官方不发布二进制集成包，所有安装路径都指向源码构建。你看到的所谓“一键集成”，本质是自动拉取 phpenv + php-build 插件 + 手动触发编译的组合流程。
- 推荐用
phpenv-installer：一行命令搞定基础环境（含插件）curl -L https://raw.githubusercontent.com/phpenv/phpenv-installer/master/bin/phpenv-installer | bash - 手动安装也行，但必须补上
php-build插件，否则phpenv install命令根本不可用：git clone https://github.com/php-build/php-build.git $(phpenv root)/plugins/php-build - Mac 用户注意：
php-build依赖autoconf、openssl、bison等系统工具，缺一个都会在phpenv install时失败，建议先brew install autoconf openssl@3 bison
phpenv install 报错“no build definition found”怎么办
这是最常卡住新手的错误，本质是 php-build 缺少对应 PHP 版本的定义文件。不是你的网络问题，也不是 phpenv 装错了。
- 先确认
php-build插件已更新：cd $(phpenv root)/plugins/php-build && git pull - 再查你要装的版本是否被支持：
phpenv install -l | grep "8.3"（比如想装 8.3.13，就搜 8.3） - 如果列表里没有，说明该版本尚未被
php-build收录——此时不能硬装，得等插件更新，或自己写 build definition（不推荐初学者） - 临时解法：换一个已列出的稳定小版本，比如
phpenv install 8.3.12
装完版本后 php -v 还是旧版本？记得 rehash
phpenv install 只负责编译安装，不会自动把新二进制注入 shims。漏掉这步，php 命令永远调不到刚装的版本。
- 每次成功运行
phpenv install X.Y.Z后，必须立刻执行：phpenv rehash - 验证是否生效：
phpenv versions（看新版本是否出现在列表）phpenv global X.Y.Z（设为全局）php -v（最终确认输出） - 如果
php -v没变，优先检查which php是否指向~/.phpenv/shims/php；如果不是，说明 shell 初始化没生效，重跑source ~/.bashrc或重启终端
.php-version 文件不生效？权限和位置是关键
项目级版本控制靠的是当前目录下的 .php-version 文件，但它非常挑剔：
- 文件必须位于你执行
php命令的**当前工作目录**（不是父目录，不是子目录） - 内容只能有一行，且严格为版本号，不能带空格或注释：
8.3.13✅php 8.3.13❌8.3.13 # latest❌ - 文件权限需可读：
chmod 644 .php-version，尤其在 Windows 子系统（WSL）或某些 NFS 挂载下容易因权限被忽略 - 若同时存在
phpenv local设置和.php-version，后者优先级更高；但phpenv shell会覆盖二者
真正麻烦的从来不是装几个版本，而是每个版本背后要配 OpenSSL、cURL、PDO 扩展、甚至 ZTS/NTS 模式——这些全靠 PHP_BUILD_CONFIGURE_OPTS 控制，一不留神就编译出无法运行 CLI 的 PHP。动手前先想清楚：你到底需要哪个扩展、要不要调试符号、是否要禁用默认不安全的配置。这些细节，比“怎么装”重要得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
