phpenv（小写）是跨平台PHP版本管理工具，仅管理PHP二进制与扩展切换；phpEnv（大写E）是Windows图形化集成环境，二者命令、路径、配置全不兼容。
phpenv 和 phpEnv 不是同一个工具，别装错
很多人搜“phpEnv”实际想用的是 phpenv（小写 p、h、p、e、n、v），一个类 rbenv 的纯 Shell 版本管理器；而“phpEnv”（大写 E）是 Windows 下的图形化集成环境（类似 XAMPP），官网是 https://www.phpenv.cn/。两者完全不兼容，命令、路径、配置方式全不同。装错会导致 phpenv 命令找不到，或在 Linux/macOS 上试图运行 Windows 安装包失败。
本文默认你目标是跨平台、可脚本化、开发者向的 phpenv —— 它不带 Apache/MySQL，只管 PHP 二进制和扩展版本切换。
手动安装 phpenv：克隆 + PATH + init 缺一不可
官方推荐方式是 Git 克隆，不是下载 ZIP 或用第三方 installer（如 phpenv-installer 已多年未维护，容易出 command not found）：
- 执行
git clone https://github.com/phpenv/phpenv.git ~/.phpenv（注意用 GitHub 官方源，不是镜像站，避免插件缺失） - 把
~/.phpenv/bin加入PATH：在~/.bashrc或~/.zshrc末尾加一行export PATH="$HOME/.phpenv/bin:$PATH" - 必须启用 shims：再加一行
eval "$(phpenv init -)"—— 这步漏掉，php命令永远调不到 phpenv 管理的版本 - 执行
source ~/.zshrc（或对应 shell 配置），然后运行phpenv --version验证；若报错no such command 'init'，说明克隆不完整，删掉~/.phpenv重来
安装 PHP 版本前，先装系统依赖，否则编译必挂
phpenv install 是从源码编译，不是下载预编译包。Ubuntu/Debian 系统至少要装：
立即学习“PHP免费学习笔记（深入）”；
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev- macOS 用户用 Homebrew：
brew install autoconf automake openssl@3 readline sqlite3 xz（注意 OpenSSL 版本需匹配 PHP 要求） - 缺少
libreadline-dev会导致 configure 阶段报 “readline not found”；缺少zlib1g-dev则gzopen相关函数失效 - 运行
phpenv install --list查看可用版本，但别直接装最新 RC 版（如8.4.0RC3），稳定选8.3.13或8.2.24
三种版本作用域：global / local / shell，行为差异极大
phpenv 不是“一键切换全局 PHP”，它按优先级生效：
-
phpenv global 8.2.24：写入~/.phpenv/version，影响所有目录（除非被更高级规则覆盖） -
phpenv local 8.1.29：在当前目录生成.php-version文件，进入该目录及子目录时自动生效（Git 可提交，团队统一） -
phpenv shell 7.4.33：仅当前终端会话有效，退出即失效；适合临时测试旧版兼容性 - 优先级顺序是：shell > local > global；
phpenv versions输出带*的是当前实际生效版本 - 切完版本后务必运行
phpenv rehash（尤其新增了扩展），否则php -m可能看不到刚装的模块
最容易忽略的是 .php-version 文件的换行符：Windows 编辑器保存可能带 \r\n，导致 phpenv 解析失败，报 “invalid version string”。用 cat -A .php-version 检查，确保只有数字和点，结尾无多余字符。
