本教程旨在解决PHP环境中Redis扩展（ext-redis）安装与识别的常见问题。文章将详细指导如何安装Redis服务器、通过PECL安装PHP Redis扩展，并正确配置PHP以启用该扩展，确保其在PHP应用中正常运行，从而替代基于客户端库的解决方案，提升性能。
1. 理解 Redis 服务器与 PHP Redis 扩展的区别
在开始安装之前，首先需要明确一个关键概念：Redis 服务器（Redis Server）和 PHP Redis 扩展（PHP Redis Extension，即 ext-redis）是两个不同的组件。
Redis 服务器： 这是一个独立的数据库服务，负责存储和管理数据。PHP Redis 扩展需要连接到正在运行的Redis服务器才能进行数据操作。PHP Redis 扩展： 这是一个用C语言编写的PHP模块，提供了PHP与Redis服务器进行通信的API。它通常比纯PHP实现的客户端库（如Predis）具有更高的性能。
许多用户在尝试安装 ext-redis 时，可能只下载了扩展文件，却忽略了Redis服务器的安装，或者混淆了两者的安装步骤，导致扩展无法正常工作。
2. 安装 Redis 服务器
PHP Redis 扩展需要一个正在运行的Redis服务器才能工作。以下是在Linux/macOS环境下安装Redis服务器的步骤。对于Windows用户，通常建议下载官方预编译版本或使用WSL。
创建安装目录并下载Redis源码：
立即学习“PHP免费学习笔记（深入）”；
mkdir -p ~/redis_install && cd ~/redis_installcurl -O http://download.redis.io/redis-stable.tar.gz
这里我们创建了一个名为 redis_install 的目录，并下载了最新稳定版的Redis源码包。
解压源码包：
tar xzvf redis-stable.tar.gzcd redis-stable
进入解压后的Redis源码目录。
编译和安装Redis：
makemake test # 可选：运行测试以确保编译正确sudo make install
make 命令会编译Redis源码。make test 会运行单元测试，确保Redis功能正常，这一步可能需要一些时间。sudo make install 将Redis的可执行文件（如 redis-server, redis-cli）安装到系统路径中（通常是 /usr/local/bin），以便全局调用。
启动 Redis 服务器：安装完成后，可以通过以下命令启动Redis服务器：
redis-server
若要让Redis在后台运行，可以使用配置文件启动：
# 复制默认配置文件sudo cp redis.conf /etc/redis/redis.conf# 编辑配置文件，将 daemonize no 改为 daemonize yessudo vi /etc/redis/redis.conf# 以后台模式启动redis-server /etc/redis/redis.conf
可以通过 redis-cli ping 命令来验证Redis服务器是否正在运行，如果返回 PONG 则表示成功。
3. 安装 PHP Redis 扩展
在Redis服务器成功运行后，我们就可以安装PHP Redis扩展了。推荐使用PECL（PHP Extension Community Library）来安装，因为它能自动处理编译和依赖。
确保安装了PHP开发工具：在Linux系统上，您可能需要安装 php-dev 或 php-devel 包，以及 autoconf 等工具。
Debian/Ubuntu: sudo apt install php-dev autoconfCentOS/RHEL: sudo yum install php-devel autoconfmacOS (通过Homebrew): brew install autoconf (PHP开发工具通常随PHP安装)
使用 PECL 安装 Redis 扩展：
sudo pecl install redis
在安装过程中，PECL可能会询问一些问题，通常直接按回车键接受默认值即可。
Windows 环境下的安装：对于Windows用户，通常不通过PECL编译安装。而是从 PECL 官网 下载预编译的 .dll 文件。
访问PECL Redis页面，选择与您的PHP版本（例如PHP 7.4）和架构（x64/x86）、线程安全（TS/NTS）相匹配的最新稳定版。下载 .zip 文件，解压后找到 php_redis.dll 文件。将 php_redis.dll 复制到您的PHP安装目录下的 ext 文件夹中（例如 C:phpext）。
4. 启用 Redis 扩展
安装完扩展后，还需要在PHP配置文件中启用它。
定位 php.ini 文件：您可以使用 php –ini 命令来查找当前CLI环境使用的 php.ini 文件路径，或通过 phpinfo() 函数在Web服务器环境中查看。
对于WAMP/MAMP等集成环境，通常会有多个 php.ini 文件，请确保修改的是当前Web服务器（如Apache）正在使用的那个。
编辑 php.ini 文件：使用文本编辑器打开找到的 php.ini 文件，并在其中添加一行：
extension=redis.so
如果您在Windows上，则应为：
extension=redis.dll
确保 extension_dir 指令指向了您的PHP扩展目录（例如 /usr/lib/php/20190902 或 C:phpext）。
5. 重启 Web 服务器
修改 php.ini 文件后，必须重启您的Web服务器（如Apache、Nginx、PHP-FPM）或WAMP/MAMP服务，以使更改生效。
Apache: sudo systemctl restart apache2 或 sudo service apache2 restartNginx + PHP-FPM: sudo systemctl restart nginx 和 sudo systemctl restart php-f7.4-fpm (根据您的PHP版本调整服务名)WAMP/MAMP: 通过其控制面板重启所有服务。
6. 验证安装
最后一步是验证Redis扩展是否已成功加载。
通过命令行验证：
php -m | grep redis
如果输出中包含 redis，则表示扩展已成功加载。
通过 phpinfo() 验证：创建一个包含 的PHP文件（例如 info.php），将其放置在Web服务器的根目录，并通过浏览器访问。在输出页面中搜索 “redis”，如果看到一个独立的 “redis” 配置块，则表示扩展已成功启用。
注意事项与常见问题
PHP 版本兼容性： 确保您安装的Redis扩展版本与您的PHP版本兼容。PECL通常会自动处理，但手动下载DLL时需特别注意。extension_dir 配置： 确保 php.ini 中的 extension_dir 指令正确指向了您的PHP扩展存放目录。权限问题： 在编译和安装过程中，如果遇到权限错误，请检查您的用户权限或使用 sudo。WAMP/MAMP 环境： 这些集成环境通常有自己的PHP版本管理和 php.ini 文件，请确保修改的是当前激活的PHP版本对应的 php.ini。错误日志： 如果扩展加载失败，请检查PHP的错误日志（通常在 php.ini 中配置 error_log）以获取详细错误信息。
通过遵循上述步骤，您应该能够成功在PHP环境中安装和启用Redis扩展，从而为您的PHP应用程序提供高效的Redis连接能力。
以上就是PHP环境下安装Redis扩展：从服务器到PHP配置的完整指南的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1319831.html
微信扫一扫 
支付宝扫一扫 
