如何安装和启用 PHP Redis 扩展

本教程旨在解决 PHP 应用程序中 Redis 扩展缺失的问题，特别是针对 PHP 7.4 版本。文章将详细指导用户通过 PECL 或手动编译两种方法安装 PHP Redis 扩展，并涵盖 php.ini 配置、服务重启及验证步骤，确保 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 及更高版本。

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

• 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 服务器。如果尚未安装，您可以参考以下命令（以编译安装为例）：

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

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

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

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

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

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

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

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

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

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

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

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

2. 解压并进入目录:

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

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

4. 配置、编译和安装:

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

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

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

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

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

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

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

• Apache:
• Nginx 和 PHP-FPM:
• WAMP/MAMP/XAMPP:
  通过其控制面板或菜单重启所有服务。

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

1. 通过命令行验证:

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

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

• "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 文件。

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

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