PHP Redis扩展安装教程：解决依赖缺失与环境配置-php教程-PHP中文网

PHP Redis扩展安装教程：解决依赖缺失与环境配置

DDD

发布： 2025-09-19 15:21:01

原创

870人浏览过

php redis扩展安装教程：解决依赖缺失与环境配置

本教程旨在指导用户如何在PHP环境中正确安装和启用Redis扩展，以解决常见的ext-redis依赖缺失问题，特别是针对PHP 7.4版本。文章将详细介绍通过PECL或手动编译安装扩展的步骤，并涵盖php.ini配置、安装验证及常见问题排查，确保PHP应用能够顺利与Redis服务器进行交互。

引言：为何需要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。

方法二：手动编译安装

如果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包。
配置编译参数：

依图语音开放平台
依图语音开放平台

6

查看详情
```
./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的文件，内容如下：
```
<?php
phpinfo();
?>
```
登录后复制
将其放置在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配置和验证步骤，可以最大程度地减少安装过程中可能遇到的问题。

以上就是PHP Redis扩展安装教程：解决依赖缺失与环境配置的详细内容，更多请关注php中文网其它相关文章！