phpenv安装需四步：克隆或自动安装→配置PATH与init→安装php-build插件→install并rehash版本；项目级通过.php-version文件绑定版本，优先级高于global。
如果您希望在本地快速搭建支持多版本PHP的开发环境，但尚未配置phpEnv工具，则可能是由于安装步骤缺失或环境变量未正确设置。以下是完成phpEnv安装与基础使用的具体操作流程：
一、选择安装方式并执行克隆或自动安装
phpEnv提供两种主流安装路径：通过git手动克隆仓库，或使用官方提供的phpenv-installer脚本一键部署。两种方式均将工具安装至用户主目录下的.phpenv路径，确保不影响系统全局PHP。
1、执行自动安装命令（推荐初学者）：
curl -L https://raw.githubusercontent.com/phpenv/phpenv-installer/master/bin/phpenv-installer | bash
2、若自动安装失败或需自定义路径，可采用手动方式：
git clone https://github.com/phpenv/phpenv.git ~/.phpenv
立即学习“PHP免费学习笔记（深入）”；
3、验证仓库完整性：
执行 ls -la ~/.phpenv/bin 后应可见 phpenv 可执行文件
二、配置Shell环境变量
为使终端能识别phpenv命令及后续PHP版本切换功能，必须将phpenv的bin目录加入PATH，并加载其初始化脚本。该步骤直接影响所有后续操作是否生效。
1、编辑当前Shell配置文件（Bash用户修改 ~/.bashrc 或 ~/.bash_profile；Zsh用户修改 ~/.zshrc）：
echo 'export PATH="$HOME/.phpenv/bin:$PATH"' >> ~/.bashrc
2、追加phpenv初始化指令：
echo 'eval "$(phpenv init -)"' >> ~/.bashrc
3、重新加载配置：
source ~/.bashrc
4、确认生效：
执行 phpenv --version 应输出版本号，无“command not found”报错
三、安装php-build插件以支持PHP版本编译
phpenv本身不包含PHP源码编译能力，需依赖php-build插件下载、配置并构建指定PHP版本。该插件默认存放于$(phpenv root)/plugins/php-build目录中。
1、克隆php-build插件仓库：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build
2、检查插件是否被识别：
phpenv install --list | head -5
3、如提示“php-build not found”，请确认插件路径拼写正确且权限可读：
$(phpenv root) 输出应为 /home/用户名/.phpenv（Linux/macOS）或对应Windows WSL路径
四、安装并切换PHP版本
安装PHP版本前需确保系统已具备编译依赖（如autoconf、bison、libssl-dev等）。安装完成后，phpenv通过shim机制将php命令重定向至对应版本的二进制文件。
1、安装PHP 8.3.13：
phpenv install 8.3.13
2、刷新shim链接（关键步骤，不可跳过）：
phpenv rehash
3、设为全局默认版本：
phpenv global 8.3.13
4、验证结果：
php -v
5、查看已安装全部版本：
phpenv versions
6、若 php -v 显示旧版本，请运行 which php 并确认输出路径是否为 ~/.phpenv/shims/php
五、项目级PHP版本绑定
为保障团队协作一致性，可在项目根目录创建.php-version文件，使phpenv自动识别并激活该目录下指定的PHP版本，优先级高于全局设置。
1、进入目标项目目录：
cd /path/to/your/project
2、写入所需版本号：
echo "7.4.33" > .php-version
3、立即生效（无需重启终端）：
phpenv local 7.4.33
4、确认当前作用域版本：
phpenv version
5、.php-version 文件内容必须为纯数字版本号（如 8.2.10），不可含空格或额外字符
