phpenv需手动克隆配置并执行eval "$(phpenv init -)"才生效；缺git、编译工具链或开发库会导致install失败；须额外安装php-build插件；装完需用phpenv global指定版本才能正常使用。
phpenv 不是开箱即用的二进制工具，必须手动克隆 + 配置 shell 环境才能生效；跳过 eval "$(phpenv init -)" 这一步，后续所有命令都会报 command not found: phpenv。
安装前必须确认的三件事
你的系统得先有这些基础组件，否则 phpenv install 会直接失败：
-
git：用来克隆仓库，没它连源码都拉不下来 -
gcc、make、autoconf、libtool：PHP 编译依赖，Ubuntu/Debian 上装build-essential，CentOS/RHEL 上装Development Tools -
libxml2-dev、libssl-dev、zlib1g-dev（或对应-devel包）：PHP 核心扩展编译所需，漏一个就可能卡在 configure 阶段
四步完成安装（bash/zsh 通用）
以下操作全部在终端执行，别复制整段粘贴，一行一行来：
- 克隆到标准路径：
git clone https://gitcode.com/gh_mirrors/ph/phpenv.git ~/.phpenv - 写入环境变量（注意：bash 用户改
~/.bashrc，zsh 用户改~/.zshrc）：echo 'export PATH="$HOME/.phpenv/bin:$PATH"' >> ~/.bashrc - 启用 shims 和自动补全：
echo 'eval "$(phpenv init -)"' >> ~/.bashrc - 重载配置：
source ~/.bashrc（别用exec $SHELL -l，容易丢掉当前终端已有环境）
验证是否成功：phpenv --version 能输出版本号，且 which php 返回的是 ~/.phpenv/shims/php，才算真正就位。
为什么装完还不能 phpenv install？
因为 phpenv install 是插件功能，默认不带。你得先装 php-build：
- 运行：
git clone https://github.com/php-build/php-build.git ~/.phpenv/plugins/php-build - 再试：
phpenv install --list就能看到可选版本了 - 常见坑：
phpenv install 8.3.13失败时，先看错误里有没有configure: error:，大概率是缺开发包；如果卡在downloading，说明国内网络访问 github raw 域名慢，可临时加代理或换镜像源
装好后第一件事：设全局版本
刚装完没有默认 PHP，php -v 会报错。必须显式指定一个全局版本，否则连 composer 都跑不起来：
- 先装一个稳定版：
phpenv install 8.3.13 - 设为全局：
phpenv global 8.3.13 - 立刻验证：
php -v输出应含8.3.13，且which php仍指向 shims 目录
注意：phpenv global 写的是版本号字符串，不是路径，也别加 v 前缀（比如不要写 v8.3.13）；写错会导致 phpenv versions 里显示红字错误。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
