PHP Redis模块与PHP编译API版本不匹配问题及解决咨询

核心原因是系统中可能共存多个PHP版本（比如PHP8.3的API为20230831），导致pecl默认关联了高版本PHP的编译工具，最终生成了不匹配的扩展文件。以下是具体解决步骤：

1. 确认当前PHP的编译工具路径 #

先确保你使用的是PHP8.2对应的phpize和php-config：

• 执行which php获取当前PHP路径，比如输出/usr/bin/php，则对应的编译工具路径为/usr/bin/phpize和/usr/bin/php-config
• 验证版本匹配性：

  phpize -v
  # 输出应包含PHP API版本: 20220829
  php-config --phpapi
  # 输出应为20220829
  

2. 编译安装匹配API版本的redis扩展 #

方法一：通过pecl指定版本并绑定正确的php-config #

redis 5.3.7及以下版本兼容PHP8.2，执行以下命令安装：

pecl install --configureoptions 'php-config=/usr/bin/php-config' redis-5.3.7

若不指定版本，pecl会默认安装最新版，而最新版可能仅支持更高版本PHP（比如PHP8.3）

方法二：源码编译（更可控） #

1. 下载对应版本的redis扩展源码：

   git clone https://github.com/phpredis/phpredis.git
   cd phpredis
   git checkout 5.3.7  # 切换到兼容PHP8.2的版本
   

2. 用PHP8.2的phpize初始化编译环境：

   /usr/bin/phpize
   

3. 配置编译参数，绑定正确的php-config：

   ./configure --with-php-config=/usr/bin/php-config
   

4. 编译并安装：

   make && make install
   

   安装完成后，redis.so会生成在PHP8.2的扩展目录（如/usr/lib/php/20220829/）

3. 配置PHP加载扩展 #

1. 找到PHP配置文件路径：

   php --ini
   

2. 编辑主php.ini文件，添加以下内容：

   extension=redis.so
   

3. 重启PHP服务（根据你的运行环境选择对应命令）：

   # 若用php-fpm
   systemctl restart php8.2-fpm
   # 若用apache
   systemctl restart apache2
   

4. 验证安装：

   php -m | grep redis
   

   若输出redis且无API版本不匹配的警告，则安装成功。

4. 清理错误安装残留 #

删除之前错误安装的扩展文件：

rm /usr/lib/php/20230831/redis.so

内容的提问来源于stack exchange，提问作者Leon Segal