phpEnv多版本快速搭建教程 phpEnv安装包下载-php教程-PHP中文网

phpenv是类unix系统下的shell脚本工具，无windows安装包，需git克隆仓库、配置path及启用php-build插件；官网仅提供源码，安装依赖系统开发库与版本定义同步。

phpenv多版本快速搭建教程 phpenv安装包下载

phpenv 不是“安装包下载型”工具，没有 Windows 那种 .exe 或 .zip 一键安装包；它本质是 Shell 脚本集合，必须通过 Git 克隆 + 环境变量配置才能用起来。 直接去 phpenv.cn 下载的“phpEnv”是另一个同名但完全无关的 Windows 图形化集成环境（含 Apache/Nginx/MySQL），和命令行版 phpenv 不兼容、不互通、不能混用。

为什么找不到 phpenv 官方安装包？

因为 phpenv 是类 Unix 系统（macOS/Linux）下的版本管理器，设计逻辑就是源码即工具：

它没有预编译二进制，所有 PHP 版本都由本地 php-build 插件从源码编译生成
所谓“安装”，实际是克隆仓库到 ~/.phpenv，再把它的 bin/ 加进 $PATH
官网 phpenv.github.io 和镜像源（如 https://gitcode.com/gh_mirrors/ph/phpenv）只提供 Git 仓库

macOS / Linux 快速装好 phpenv 的三步实操

跳过所有图形化包装，直取可用状态：

1. 克隆仓库（推荐用 GitCode 镜像，国内更快）：
git clone https://gitcode.com/gh_mirrors/ph/phpenv ~/.phpenv

2. 启用插件并配置 shell（注意：必须同时加 php-build，否则 phpenv install 会报错 command not found: phpenv-install）：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build
然后往 ~/.bash_profile 或 ~/.zshrc 追加两行：
export PATH="$HOME/.phpenv/bin:$PATH"
eval "$(phpenv init -)"

3. 重载配置并验证：
source ~/.zshrc（或 source ~/.bash_profile）
phpenv --version 应输出类似 phpenv 1.2.4

phpenv install 报错 “No definition for 8.3.13” 怎么办？

这是最常卡住的点：默认仓库不带 PHP 版本定义文件，需手动同步 php-build 的 definitions 目录。

执行这一步补全定义：
$(phpenv root)/plugins/php-build/share/php-build/definitions 目录下应有 8.3.13 这类文件 —— 如果没有，运行：
cd $(phpenv root)/plugins/php-build && git pull

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

再试：
phpenv install 8.3.13

常见失败原因还包括：
- 缺少系统依赖（如 autoconf、openssl-devel、libxml2-devel）
- macOS 上未装 Command Line Tools：xcode-select --install
- 使用了 zsh 但配置写进了 .bash_profile，导致 phpenv init 没生效