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 扩展最简单和推荐的方式。
-
安装 PECL (如果尚未安装): 在大多数 Linux 发行版上，PECL 通常与 php-dev 或 php-pear 包一起安装。如果 pecl 命令不可用，您可能需要手动安装 PEAR 和 PECL。
sudo apt install php-pear # Debian/Ubuntu sudo yum install php-pear # CentOS/RHEL
-
通过 PECL 安装 Redis 扩展: 执行以下命令来安装 Redis 扩展：
sudo pecl install redis
在安装过程中，可能会询问一些配置选项。通常情况下，直接按 Enter 键接受默认值即可。
- 常见问题： 如果遇到编译错误，通常是缺少 php-dev 包或相关的编译器工具（如 gcc）。请确保您的开发工具已正确安装。
3.2 方法二：手动从源代码编译 (备选)
如果 PECL 安装失败或您需要特定版本的扩展，可以手动编译。
-
下载 Redis 扩展源代码: 访问 PECL 官网的 Redis 页面 下载最新或指定版本的 .tgz 文件。
wget https://pecl.php.net/get/redis-5.3.7.tgz # 替换为最新版本号
-
解压并进入目录:
tar xzvf redis-5.3.7.tgz cd redis-5.3.7
-
准备编译: 使用 phpize 工具为当前 PHP 版本准备编译环境。
phpize
如果 phpize 命令未找到，请检查您的 php-dev 包是否已安装且 phpize 在 PATH 中。
-
配置、编译和安装:
./configure make sudo make install
make install 命令会将编译好的 redis.so (或 redis.dll 在 Windows 上) 文件放置到 PHP 扩展目录中。
4. 启用 PHP Redis 扩展
安装完成后，您需要告诉 PHP 加载这个新安装的扩展。
-
定位 php.ini 文件: PHP 可能有多个 php.ini 文件，例如一个用于 CLI (命令行界面)，一个用于 Web 服务器 (如 Apache、Nginx 或 PHP-FPM)。您需要编辑 Web 服务器使用的那个。 要查找当前 PHP 配置使用的 php.ini 文件路径，可以运行：
php --ini
或者创建一个包含 的 PHP 文件，通过浏览器访问它，查找 "Loaded Configuration File" 条目。
-
编辑 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 扩展是否已成功加载。
-
通过命令行验证:
php -m | grep redis
如果输出中包含 redis，则表示扩展已加载。
通过 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 服务，并验证扩展是否已成功加载。
