phpenv是常用的PHP多版本管理工具，能让同一台设备上同时存在多个PHP版本并自由切换，在phpenv环境下安装PHP扩展和直接在系统PHP环境下安装存在一定差异，需要遵循对应的操作逻辑才能保证扩展正常生效。
安装前的准备工作
在开始安装扩展前，需要先确认当前使用的PHP版本，避免扩展安装到错误的版本目录下。可以通过phpenv的版本查看命令确认当前生效的PHP版本：
phpenv version
如果需要安装扩展的PHP版本不是当前生效版本，需要先切换到目标版本：
phpenv local 7.4.33 # 上述命令将当前目录的PHP版本切换为7.4.33，全局切换可使用phpenv global 7.4.33
同时需要确认系统已经安装了对应PHP版本的编译依赖，比如如果要安装需要编译的扩展，需要确保gcc、make、autoconf等编译工具已经安装，不同系统的安装命令如下：
- Ubuntu/Debian系统：
sudo apt-get install gcc make autoconf - CentOS/RHEL系统：
sudo yum install gcc make autoconf
使用pecl安装扩展
pecl是PHP官方的扩展管理工具，大部分常用的PHP扩展都可以通过pecl直接安装，phpenv环境下使用pecl安装扩展的步骤如下：
步骤1：确认pecl路径
首先确认当前PHP版本对应的pecl路径，避免调用到系统其他PHP版本的pecl：
which pecl # 输出路径应该包含phpenv的版本目录，比如/root/.phpenv/versions/7.4.33/bin/pecl
步骤2：执行安装命令
以安装redis扩展为例，执行以下命令：
pecl install redis
安装过程中如果出现依赖提示，根据提示安装对应的依赖即可，比如安装redis扩展可能需要先安装libredis-dev。
步骤3：添加扩展到配置文件
扩展安装完成后，需要将扩展配置添加到当前PHP版本的配置文件中，首先找到当前PHP版本的配置文件目录：
php_config_dir=$(phpenv prefix)/etc/php.d mkdir -p $php_config_dir echo "extension=redis.so" > $php_config_dir/redis.ini
手动编译安装扩展
部分扩展没有收录到pecl仓库，或者需要自定义扩展版本，就需要手动下载扩展源码编译安装，步骤如下：
步骤1：下载扩展源码
以安装swoole扩展为例，从官方仓库下载对应版本的源码包：
wget https://pecl.php.net/get/swoole-4.8.13.tgz tar -zxvf swoole-4.8.13.tgz cd swoole-4.8.13
步骤2：生成编译配置
使用当前PHP版本对应的phpize生成编译配置：
$(phpenv prefix)/bin/phpize
步骤3：编译安装
执行配置、编译、安装命令：
./configure --with-php-config=$(phpenv prefix)/bin/php-config make make install
步骤4：添加扩展配置
同样需要将扩展配置添加到PHP的配置目录中：
echo "extension=swoole.so" > $(phpenv prefix)/etc/php.d/swoole.ini
安装后验证扩展是否生效
扩展安装完成后，需要验证扩展是否成功加载到当前PHP版本中，有两种常用的验证方式：
方式1：使用php -m命令查看
执行以下命令查看已加载的扩展列表：
php -m | grep redis
如果输出redis，说明扩展已经成功加载。
方式2：通过phpinfo查看
可以创建一个php测试文件，内容如下：
<?php phpinfo();
在浏览器中访问该文件，搜索对应的扩展名称，查看是否存在对应的扩展模块信息。
常见问题处理
1. 扩展安装后没有生效：检查是否切换到了正确的PHP版本，扩展配置文件是否放在了当前PHP版本的配置目录下，可通过php --ini命令查看PHP加载的配置文件路径。
2. 编译扩展时提示找不到php-config：确认使用的php-config路径是当前phpenv管理的PHP版本路径，可通过$(phpenv prefix)/bin/php-config --version确认版本是否正确。
3. 扩展版本和PHP版本不兼容：安装扩展时注意查看扩展支持的PHP版本范围，选择对应PHP版本兼容的扩展版本安装。