本教程旨在解决PHP应用中因缺少Redis扩展（ext-redis）而导致的依赖错误。文章将详细指导如何安装Redis服务器，进而安装并启用PHP Redis扩展，确保PHP应用能够顺利连接和操作Redis数据库，并提供验证方法和常见问题解决方案。
引言：理解 PHP Redis 扩展的重要性
在现代PHP开发中，Redis作为高性能的键值存储系统，常被用于缓存、会话管理、消息队列等场景。为了让PHP应用能够与Redis服务器进行交互，必须安装并启用PHP的Redis扩展（通常是php-redis或ext-redis）。当此扩展缺失时，Composer等依赖管理工具可能会报错，提示Root composer.json requires PHP extension ext-redis * but it is missing from your system. Install or enable PHP’s redis extension. 这意味着您的PHP环境未能提供所需的Redis客户端功能。本教程将提供一套完整的安装和配置流程，帮助您解决此类问题。
1. 安装 Redis 服务器
在安装PHP Redis扩展之前，您需要确保系统上已经安装并运行了Redis服务器。PHP扩展将通过网络协议连接到这个服务器。
以下是在类Unix系统（如macOS或Linux）上编译安装Redis服务器的步骤：
# 1. 创建并进入一个临时目录用于下载和编译mkdir redis_install_temp && cd redis_install_temp# 2. 下载 Redis 稳定版源码包# 注意：此URL可能随Redis版本更新而变化，建议访问redis.io获取最新稳定版链接curl -O http://download.redis.io/redis-stable.tar.gz# 3. 解压源码包tar xzvf redis-stable.tar.gz# 4. 进入解压后的目录cd redis-stable# 5. 编译 Redis# make 命令会编译 Redis 服务器及其客户端工具make# 6. 运行测试（可选，但推荐）# make test 会运行 Redis 的单元测试，确保编译结果的稳定性make test# 7. 安装 Redis 到系统路径# sudo make install 会将 Redis 可执行文件（如 redis-server, redis-cli）安装到 /usr/local/binsudo make install
安装完成后，您可以通过运行redis-server命令来启动Redis服务器。为了生产环境的稳定性，通常会配置Redis作为系统服务启动。
立即学习“PHP免费学习笔记（深入）”；
2. 安装 PHP Redis 扩展
安装完Redis服务器后，接下来是安装PHP Redis扩展。根据您的操作系统和PHP环境，有几种常见的方法。
方法一：使用 PECL 安装 (推荐)
PECL (PHP Extension Community Library) 是PHP官方的扩展库，通过pecl命令可以方便地安装PHP扩展。
确保已安装 php-dev 或 php-devel 包：在Debian/Ubuntu上：sudo apt-get install php-dev在CentOS/RHEL上：sudo yum install php-devel在macOS上，通常随PHP安装。
使用 pecl 命令安装 Redis 扩展：
sudo pecl install redis
在安装过程中，可能会询问关于php_igbinary和php_msgpack的选项。通常可以直接按回车选择默认值。
方法二：手动编译安装
如果PECL安装遇到问题，或者您需要特定版本的扩展，可以手动从源码编译安装。
下载 PHP Redis 扩展源码：访问 https://pecl.php.net/package/redis，下载对应PHP版本的Redis扩展源码包（例如 redis-5.3.7.tgz）。
解压并进入目录：
tar xzvf redis-X.X.X.tgzcd redis-X.X.X
准备编译环境：
phpize # 生成 configure 脚本./configure # 配置编译选项
编译并安装：
makesudo make install
成功后，您会看到类似 Installing shared extensions: /usr/lib/php/20190902/ 的输出，这指示了扩展的安装路径。
方法三：针对 Windows 环境
对于WAMP、XAMPP等Windows集成环境，通常可以直接下载预编译的 .dll 文件。
下载对应 PHP 版本的 .dll 文件：访问 https://pecl.php.net/package/redis。选择与您的PHP版本、架构（x86/x64）和线程安全（TS/NTS）相匹配的 .dll 文件。例如，对于PHP 7.4 NTS x64，您需要找到 php_redis-X.X.X-7.4-nts-vc15-x64.zip。
解压 .dll 文件：将下载的压缩包解压，找到 php_redis.dll 文件。
放置 .dll 文件：将 php_redis.dll 复制到您的PHP安装目录下的 ext 文件夹中（例如 C:wamp64binphpphp7.4.Xext）。
3. 启用 Redis 扩展
无论是通过PECL、手动编译还是下载DLL，最后一步都是在 php.ini 文件中启用该扩展。
定位 php.ini 文件：php.ini 文件是PHP的配置文件。您可以通过运行 php –ini 命令来查找其位置：
php --ini
输出会显示加载的 php.ini 文件路径，例如 /etc/php/7.4/cli/php.ini 和 /etc/php/7.4/apache2/php.ini。请确保修改的是您的Web服务器（如Apache或Nginx）或PHP-FPM使用的 php.ini 文件。在WAMP或MAMP中，通常可以通过其控制面板访问。例如，MAMP的错误信息中提到 /Library/Application Support/appsolute/MAMP PRO/conf/php8.1.13.ini。
编辑 php.ini 文件：使用文本编辑器打开找到的 php.ini 文件，并在文件末尾或 Dynamic Extensions 部分添加以下行：
对于 Linux/macOS：
extension=redis.so
对于 Windows：
extension=redis.dll
如果您之前也安装了 igbinary 或 msgpack 扩展，也需要相应地启用它们：
extension=igbinary.soextension=msgpack.so
重启 Web 服务器/PHP 服务：修改 php.ini 后，必须重启您的Web服务器（如Apache、Nginx）或PHP-FPM服务，以使更改生效。
Linux/macOS (Apache): sudo service apache2 restart 或 sudo systemctl restart apache2Linux/macOS (Nginx + PHP-FPM): sudo service php7.4-fpm restart 或 sudo systemctl restart php7.4-fpmWAMP/XAMPP: 通过其控制面板重启所有服务。
4. 验证安装
安装并启用扩展后，务必验证其是否已成功加载。
通过命令行验证：运行以下命令：
php -m | grep redis
如果输出中包含 redis，则表示扩展已成功加载到CLI环境中。
通过 phpinfo() 验证：创建一个名为 info.php 的文件，内容如下：
将此文件放置在您的Web服务器根目录，并通过浏览器访问（例如 http://localhost/info.php）。在输出页面中搜索 “redis”。如果找到一个 “redis” 部分，其中包含版本信息和配置详情，则表示扩展已成功加载到Web服务器环境中。
注意事项与常见问题
PHP 版本兼容性：确保您下载的Redis扩展与您的PHP版本完全兼容。例如，PHP 7.4 的扩展不能用于 PHP 8.x。线程安全 (TS/NTS)：在Windows上，PHP分为线程安全（Thread Safe, TS）和非线程安全（Non Thread Safe, NTS）版本。请务必下载与您PHP版本匹配的扩展。php.ini 文件路径：确保您修改的是Web服务器或PHP-FPM实际加载的 php.ini 文件，而不是CLI版本的 php.ini。服务重启：任何 php.ini 的修改都需要重启相应的PHP服务才能生效。Redis 服务器与 PHP 扩展的区别：Redis服务器是独立的后台进程，负责存储和管理数据；PHP Redis扩展是PHP的一个模块，提供API让PHP代码能够与Redis服务器通信。两者都必须正确安装和运行。WAMP/MAMP 菜单未显示：在WAMP等集成环境中，即使手动放置了 .dll 文件并修改了 php.ini，其菜单界面可能不会立即更新以显示新扩展。只要通过 phpinfo() 能看到扩展，就说明它已正常工作。
通过遵循本教程的步骤，您应该能够成功安装并启用PHP Redis扩展，从而解决PHP应用中因缺少该扩展而导致的各种问题。
以上就是PHP Redis 扩展安装指南的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1319839.html
微信扫一扫 
支付宝扫一扫 
![Go语言接口与切片：如何识别和操作[]interface{}](https://cdn.chuangxiangniao.com/www/2025/12/176369856569294-1.jpg?imageMogr2/crop/480x300/gravity/center)
