phpenv需通过php-build插件编译安装新版本，或手动链接预编译包、系统PHP、自定义编译选项及PECL扩展，所有操作后均须执行phpenv rehash激活。
如果您已安装phpenv但需要增加新的PHP版本或扩展组件，则可能是由于php-build插件未启用或缺少编译依赖。以下是实现该目标的多种方法：
一、通过php-build插件安装新PHP版本
phpenv本身不直接提供PHP二进制文件，需依赖php-build插件从源码编译安装指定版本。该插件负责下载、配置、编译及安装全过程，并自动注册至phpenv管理范围。
1、确认php-build插件已安装：执行 git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build，若提示目录已存在则跳过此步。
2、更新php-build内置定义：进入插件目录运行 git pull，确保支持最新PHP版本（如8.4.x）。
立即学习“PHP免费学习笔记（深入）”；
3、安装指定PHP版本：执行 phpenv install 8.3.13，等待编译完成。
4、刷新shims缓存：安装后必须运行 phpenv rehash，使新版本命令可被识别。
二、使用预编译二进制包快速安装（免编译）
当系统缺乏编译环境（如缺失gcc、autoconf等）时，可改用第三方提供的预编译PHP二进制包，跳过源码构建阶段，显著缩短安装时间。
1、下载对应平台的PHP二进制压缩包（例如从 https://windows.php.net/downloads/releases/ 或 Linux发行版仓库获取）。
2、解压至独立目录，例如 /opt/php/8.2.10。
3、手动注册为phpenv版本：执行 ln -s /opt/php/8.2.10 ~/.phpenv/versions/8.2.10。
4、运行 phpenv rehash 激活该版本。
三、安装PHP扩展组件（PECL/PEAR）
PHP扩展需在特定版本环境下独立安装，phpenv通过shims机制确保扩展仅作用于当前激活版本，避免跨版本污染。
1、切换至目标PHP版本：执行 phpenv shell 8.3.13 或进入含.php-version文件的项目目录。
2、检查pecl是否可用：运行 pecl version，若报错则需先启用PEAR支持。
3、启用PEAR（如未内置）：重新编译该版本并添加 --with-pear 参数，或使用 curl -O https://pear.php.net/go-pear.phar && php go-pear.phar 手动安装。
4、安装扩展：例如执行 pecl install redis，安装完成后按提示将 extension=redis.so 加入对应版本的php.ini。
四、自定义编译选项安装PHP
默认编译可能禁用部分扩展（如intl、openssl），通过环境变量可注入额外configure参数，满足生产环境需求。
1、设置全局编译选项：执行 export PHP_BUILD_CONFIGURE_OPTS="--with-openssl --enable-intl --with-curl"。
2、安装时保留该环境变量：新开终端后再次运行 phpenv install 7.4.33。
3、验证扩展加载：安装完成后执行 php -m | grep openssl 确认模块存在。
五、从系统包管理器导入已有PHP版本
若系统已通过apt/yum/dnf安装多个PHP版本（如Ubuntu的ppa:ondrej/php），可将其纳入phpenv统一调度，无需重复编译。
1、查找已安装PHP路径：执行 which php7.4 和 which php8.3 获取绝对路径。
2、创建软链接映射：例如 ln -s /usr/bin/php7.4 ~/.phpenv/versions/7.4.33（注意版本号需与实际一致）。
3、为每个版本单独建立bin和lib结构（必要时复制php.ini及ext目录）。
4、执行 phpenv rehash 完成注册。
