引言：为何需要PHP Redis扩展？
在PHP开发中，当我们需要利用Redis作为缓存、消息队列或数据存储时，PHP Redis扩展（ext-redis）是实现高效、原生交互的关键。许多现代PHP框架和库（如Laravel、Symfony）在composer.json中会声明对ext-redis的依赖。如果此扩展未安装或未启用，您可能会遇到类似“Root composer.json requires PHP extension ext-redis * but it is missing from your system”的错误，导致项目无法正常运行或部署。本教程将以PHP 7.4为例，详细讲解如何解决这一问题。
前提条件
在开始安装之前，请确保您的系统满足以下条件：
- PHP环境： 您的系统已安装PHP，本教程以PHP 7.4版本为基准，但方法同样适用于其他PHP版本。
- Redis服务器： Redis服务器本身已安装并正在运行。请注意，PHP Redis扩展是用于PHP连接Redis服务器的客户端，它不包含Redis服务器本身。如果您尚未安装Redis服务器，可以参考官方文档进行安装。
- 开发工具： 确保已安装phpize、make、gcc等编译工具。在基于Debian/Ubuntu的系统上，通常可以通过安装php-dev或php-devel包来获取（例如：sudo apt install php7.4-dev）。在macOS上，Xcode Command Line Tools通常会提供这些。
安装PHP Redis扩展
安装PHP Redis扩展主要有两种方法：使用PECL（PHP Extension Community Library）或手动编译。推荐使用PECL，因为它通常更简单。
方法一：使用PECL安装（推荐）
PECL是PHP扩展的包管理工具，可以简化扩展的安装过程。
立即学习“PHP免费学习笔记（深入）”；
-
执行安装命令： 打开终端并运行以下命令：
sudo pecl install redis
在安装过程中，可能会提示您选择Redis的C客户端库（php-redis需要它）。通常情况下，直接按回车键选择默认选项即可。
-
处理phpize缺失问题： 如果在运行pecl install redis时遇到phpize命令找不到的错误，说明您的系统缺少PHP开发工具包。请根据您的操作系统安装相应的包：
-
Debian/Ubuntu:
sudo apt update sudo apt install php7.4-dev # 将7.4替换为您的PHP版本
-
CentOS/RHEL:
sudo yum install php74-php-devel # 将74替换为您的PHP版本
- macOS (MAMP/XAMPP用户可能需要特殊配置): 确保您的PATH环境变量包含了MAMP/XAMPP PHP版本的bin目录，或者直接使用其自带的phpize。
-
Debian/Ubuntu:
方法二：手动编译安装
如果PECL安装失败或您需要更精细的控制，可以手动编译安装Redis扩展。
下载Redis扩展源码： 访问PECL官网的Redis扩展页面（https://pecl.php.net/package/redis），下载最新稳定版本的.tgz文件。例如，下载redis-5.3.7.tgz。
-
解压并进入目录：
tar xzvf redis-5.3.7.tgz cd redis-5.3.7
-
准备编译环境： 运行phpize命令为当前PHP版本准备编译环境。
phpize
如果phpize找不到，请参考上方“处理phpize缺失问题”的说明安装php-dev包。
-
配置编译参数：
./configure
此步骤会检查系统依赖。如果出现错误，请根据错误信息安装缺失的库。
-
编译并安装：
make sudo make install
make install命令会将编译好的redis.so（或redis.dll）文件复制到PHP扩展目录。
启用Redis扩展
无论您使用哪种安装方法，安装完成后都需要在PHP配置文件中启用该扩展。
-
定位php.ini文件： 您可以通过以下命令找到正在使用的php.ini文件的路径：
php --ini
输出会显示加载的php.ini文件路径，例如/etc/php/7.4/cli/php.ini和/etc/php/7.4/fpm/php.ini（如果您使用PHP-FPM）。请确保同时修改CLI和FPM/Web服务器使用的php.ini文件。
-
编辑php.ini： 使用文本编辑器打开找到的php.ini文件，并在文件末尾或扩展区域添加以下行：
extension=redis.so
- Linux/macOS: 使用extension=redis.so
- Windows: 使用extension=redis.dll
-
重启Web服务器或PHP-FPM： 为了让PHP加载新的配置，您必须重启您的Web服务器（如Apache、Nginx）或PHP-FPM服务。
- Apache: sudo systemctl restart apache2 或 sudo service apache2 restart
- Nginx + PHP-FPM: sudo systemctl restart php7.4-fpm 或 sudo service php7.4-fpm restart (将php7.4-fpm替换为您的实际服务名)
- MAMP/XAMPP: 通过其控制面板重启服务。
验证安装
安装并启用扩展后，务必验证其是否已成功加载。
-
通过命令行验证： 在终端中运行以下命令：
php -m | grep redis
如果输出中包含redis，则表示扩展已成功加载。
-
通过phpinfo()验证： 创建一个名为info.php的文件，内容如下：
将其放置在Web服务器的根目录或可访问的路径下，并通过浏览器访问该文件（例如http://localhost/info.php）。在输出页面中搜索“redis”，如果能找到一个独立的“redis”模块部分，其中包含配置信息，则表示扩展已成功启用。
常见问题与注意事项
- Redis服务器与PHP Redis扩展的区别： 务必理解Redis服务器（一个独立的进程，负责数据存储和处理）与PHP Redis扩展（PHP用于连接和操作Redis服务器的客户端库）是两个不同的组件。安装PHP扩展并不能替代安装Redis服务器。本教程的重点是安装PHP扩展。
- phpize找不到： 这是最常见的问题之一。解决方法是安装PHP的开发包（如php7.4-dev）。
- ./configure报错： 通常是缺少依赖库。请仔细阅读错误信息，安装相应的开发库。例如，可能需要安装libssl-dev。
-
扩展未生效：
- 确认修改的是正确的php.ini文件。PHP CLI和Web服务器（FPM/Apache模块）可能使用不同的php.ini。
- 确保已重启Web服务器或PHP-FPM服务。
- 检查extension_dir配置项，确保redis.so文件位于PHP配置的扩展目录中。
总结
正确安装和配置PHP Redis扩展是确保PHP应用程序能够高效利用Redis服务的基础。通过本教程，您应该能够顺利地在您的PHP环境中安装并启用Redis扩展，从而解决ext-redis依赖缺失的问题，并为您的应用程序提供强大的数据交互能力。遵循推荐的PECL安装方法，并仔细检查php.ini配置和验证步骤，可以最大程度地减少安装过程中可能遇到的问题。
