phpenv是专为PHP多版本管理设计的命令行工具，通过shim机制和PATH注入实现按需切换互不干扰的PHP版本，不替代系统PHP，仅控制当前终端或目录下的php命令调用。
phpenv 是一个命令行工具，核心作用就一条：让你在一台机器上同时装多个 PHP 版本，并按需切换，互不干扰。它不替代系统 PHP，也不改注册表（Windows 版是独立产品），而是通过 shell 层级的 PATH 注入来控制哪个 php 命令被实际调用。
为什么不能直接用系统自带的 PHP？
系统预装的 PHP 通常是单版本、全局生效的，一旦升级就全项目跟着变——这在开发中极危险。比如：
- 你正在维护一个 Laravel 5.8 项目，它只兼容
PHP 7.2～7.4，但本地系统是PHP 8.2 - 你想验证一段新写的
match表达式是否在PHP 8.0+下正常运行，又不想卸载旧版 - 团队要求所有成员使用
PHP 8.1.26，但你的 CI 环境跑的是8.1.30，微小差异可能引发行为不一致
phpenv 就是为这类场景而生：它不碰系统 PHP，只管“当前终端/当前目录下该用哪个 php”。
phpenv 能干什么？关键能力拆解
它不是安装器，也不是 Web 服务器集成套件（那是 XAMPP/MAMP/WAMP 干的事），它的能力边界很清晰：
立即学习“PHP免费学习笔记（深入）”；
-
查版本：
phpenv versions列出已安装和可安装的所有 PHP 版本 -
装版本：
phpenv install 8.1.26从源码编译安装（需gcc、make、autoconf等依赖） -
切版本：
phpenv global 7.4.33设全局默认；phpenv local 8.0.30在当前目录写.phpenv-version文件，进目录自动生效 -
查当前：
phpenv version显示当前生效的版本（含 local/global 优先级判断逻辑） -
配扩展：安装时可通过
--configure-options传参，比如启用--with-openssl或禁用--disable-opcache
注意：phpenv 本身不管理 Apache/Nginx/MySQL——它只管 php 二进制文件。Web 服务仍需你单独配置，或搭配 php-fpm 使用。
容易踩的坑：别把 phpenv 当成“一键环境包”
新手常误以为装了 phpenv 就能直接跑 Laravel 或 WordPress，结果 php -v 正常，composer install 却报错。原因往往在这些地方：
- 没执行
eval "$(phpenv init -)"到 shell 配置（~/.bashrc或~/.zshrc），导致phpenv命令根本不可用 - 安装 PHP 时缺依赖，比如 Ubuntu 上没装
libxml2-dev、zlib1g-dev，编译会卡在 configure 阶段，错误信息里常带configure: error: xml2-config not found - 用了
phpenv local但忘记进项目根目录，或目录里有残留的.phpenv-version导致版本“偷偷切换” - Windows 用户混淆了两个项目：Linux/macOS 用的是开源
phpenv（rbenv 衍生），而 Windows 上叫phpEnv（闲云出品）是图形化集成环境，二者不兼容
最常被忽略的一点：每次新开终端后，phpenv 的 local 设置不会自动加载，除非你确认 shell 初始化已正确写入且 source 过——这点在 CI 脚本或 Dockerfile 里尤其关键。
