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