如何安装和启用 PHP Redis 扩展

1. 引言：为何需要 PHP Redis 扩展

在 PHP 开发中，与 Redis 缓存或数据存储进行交互是常见的需求。虽然可以使用如 Predis 这样的纯 PHP 客户端库，但直接安装 PHP Redis 扩展（ext-redis）通常能提供更好的性能、更丰富的功能以及更底层的操作能力。当您的 Composer 项目提示 "Root composer.json requires PHP extension ext-redis * but it is missing from your system" 或您发现 WAMP/MAMP 菜单中缺少 Redis 扩展选项时，这意味着您需要正确安装并启用此扩展。本教程将引导您完成这一过程，尤其适用于 PHP 7.4 及更高版本。

2. 环境准备与先决条件

在开始安装之前，请确保您的系统满足以下条件：

• PHP 版本： 本教程以 PHP 7.4 为例，但步骤同样适用于其他 PHP 7.x 或 8.x 版本。
• PHP 开发工具： 您需要安装 PHP 的开发头文件和工具，例如 phpize。
  • Debian/Ubuntu: sudo apt update && sudo apt install php-dev (或 php7.4-dev 等特定版本)
  • CentOS/RHEL: sudo yum install php-devel (或 php74-devel 等特定版本)
  • macOS (使用 Homebrew): brew install autoconf (通常随 PHP 安装)
• Redis 服务器： 确保您的系统上已安装并运行 Redis 服务器。如果尚未安装，您可以参考以下命令（以编译安装为例）：

  mkdir redis && cd redis
  curl -O http://download.redis.io/redis-stable.tar.gz
  tar xzvf redis-stable.tar.gz
  cd redis-stable
  make
  make test # 可选，运行测试
  sudo make install # 安装 Redis 服务器

  登录后复制

  请注意，上述步骤安装的是 Redis 服务器，而不是 PHP 扩展。

3. 安装 PHP Redis 扩展

有两种主要方法可以安装 PHP Redis 扩展：使用 PECL（PHP 扩展社区库）或手动从源代码编译。

立即学习“PHP免费学习笔记（深入）”；

3.1 方法一：使用 PECL (推荐)

PECL 是安装 PHP 扩展最简单和推荐的方式。

1. 安装 PECL (如果尚未安装): 在大多数 Linux 发行版上，PECL 通常与 php-dev 或 php-pear 包一起安装。如果 pecl 命令不可用，您可能需要手动安装 PEAR 和 PECL。

   sudo apt install php-pear # Debian/Ubuntu
   sudo yum install php-pear # CentOS/RHEL

   登录后复制

2. 通过 PECL 安装 Redis 扩展: 执行以下命令来安装 Redis 扩展：

   sudo pecl install redis

   登录后复制

   在安装过程中，可能会询问一些配置选项。通常情况下，直接按 Enter 键接受默认值即可。

   • 常见问题： 如果遇到编译错误，通常是缺少 php-dev 包或相关的编译器工具（如 gcc）。请确保您的开发工具已正确安装。

3.2 方法二：手动从源代码编译 (备选)

如果 PECL 安装失败或您需要特定版本的扩展，可以手动编译。

1. 下载 Redis 扩展源代码: 访问 PECL 官网的 Redis 页面 下载最新或指定版本的 .tgz 文件。

   wget https://pecl.php.net/get/redis-5.3.7.tgz # 替换为最新版本号

   登录后复制

2. 解压并进入目录:

   tar xzvf redis-5.3.7.tgz
   cd redis-5.3.7

   登录后复制

3. 准备编译: 使用 phpize 工具为当前 PHP 版本准备编译环境。

   phpize

   登录后复制

   如果 phpize 命令未找到，请检查您的 php-dev 包是否已安装且 phpize 在 PATH 中。

   

   乐活途购物分享社区

   beta v1.1版本为第一个版本，简单的整合了基础功能，各位站长拿到程序后，不要纠结后台的功能简单，后续将不断更新扩展。在beta v1.1版本使用过程中遇到什么问题，请登录 www.loftto.com 进行反馈！ 安装说明######重要提醒：程序不支持二级目录安装，请使用一级目录或二级目录绑定！#第一步，确定你的服务器支持PHP+mysql。#第二步，确定你的服务器开启了gd库。#第三步，

   0

   查看详情

4. 配置、编译和安装:

   ./configure
   make
   sudo make install

   登录后复制

   make install 命令会将编译好的 redis.so (或 redis.dll 在 Windows 上) 文件放置到 PHP 扩展目录中。

4. 启用 PHP Redis 扩展

安装完成后，您需要告诉 PHP 加载这个新安装的扩展。

1. 定位 php.ini 文件: PHP 可能有多个 php.ini 文件，例如一个用于 CLI (命令行界面)，一个用于 Web 服务器 (如 Apache、Nginx 或 PHP-FPM)。您需要编辑 Web 服务器使用的那个。 要查找当前 PHP 配置使用的 php.ini 文件路径，可以运行：

   php --ini

   登录后复制

   或者创建一个包含 <?php phpinfo(); ?> 的 PHP 文件，通过浏览器访问它，查找 "Loaded Configuration File" 条目。

2. 编辑 php.ini 文件: 使用文本编辑器打开找到的 php.ini 文件，并在文件末尾或扩展部分添加以下行：

   extension=redis.so

   登录后复制
   • Windows 用户注意： 如果您在 Windows 环境下使用 WAMP/XAMPP，通常是 extension=redis.dll，并且您可能需要将下载的 redis.dll 文件手动放置到 PHP 的 ext 目录下。

5. 重启服务

为了让 PHP 加载新的配置和扩展，您必须重启相关的服务。

• Apache:

  sudo service apache2 restart # Debian/Ubuntu
  sudo systemctl restart httpd # CentOS/RHEL

  登录后复制
• Nginx 和 PHP-FPM:

  sudo service nginx restart
  sudo service php7.4-fpm restart # 替换为您的 PHP-FPM 版本

  登录后复制
• WAMP/MAMP/XAMPP: 通过其控制面板或菜单重启所有服务。

6. 验证安装

安装并重启服务后，务必验证 Redis 扩展是否已成功加载。

1. 通过命令行验证:

   php -m | grep redis

   登录后复制

   如果输出中包含 redis，则表示扩展已加载。

2. 通过 phpinfo() 验证: 再次访问包含 <?php phpinfo(); ?> 的 PHP 页面。在输出中搜索 "redis" 部分。如果找到，表示扩展已成功启用，并会显示其版本和配置信息。

7. 故障排除与注意事项

• "Unable to load dynamic library" 错误： 这通常意味着 redis.so 文件不存在、路径不正确，或者编译的扩展与当前 PHP 版本不兼容。请检查 php.ini 中的 extension_dir 配置，并确保 redis.so 位于该目录或指定了完整路径。
• WAMP/MAMP 菜单未显示： 在 Windows 环境下，确保 redis.dll 文件已正确放置在 PHP 的 ext 目录下，并且 php.ini 文件中已添加 extension=redis.dll。WAMP/MAMP 通常有自己的 PHP 版本管理，确保您修改的是当前激活 PHP 版本的 php.ini。
• PHP 版本兼容性： 确保您下载或编译的 Redis 扩展版本与您的 PHP 版本兼容。PECL 通常会自动处理兼容性问题。
• 权限问题： 确保 make install 命令使用 sudo 运行，以避免权限不足导致文件无法写入扩展目录。
• 多个 php.ini 文件： 始终通过 php --ini 或 phpinfo() 确认您正在编辑正确的 php.ini 文件。

8. 总结

正确安装和启用 PHP Redis 扩展是优化 PHP 应用程序与 Redis 交互的关键一步。通过遵循本教程中的 PECL 或手动编译方法，并仔细配置 php.ini 文件，您可以成功解决 "ext-redis is missing" 的问题，并充分利用 Redis 带来的性能优势。记得在任何配置更改后重启您的 Web 服务器或 PHP-FPM 服务，并验证扩展是否已成功加载。

以上就是如何安装和启用 PHP Redis 扩展的详细内容，更多请关注php中文网其它相关文章！