首先确认Redis服务已启动且PHP版本兼容，接着安装并启用php-redis扩展，配置php.ini加载redis模块，重启Apache服务，最后通过测试脚本验证连接，若失败则检查防火墙及Redis绑定地址设置。
如果您在Ubuntu系统中配置PHP与Redis集成时遇到连接失败或扩展无法加载的问题，可能是由于环境配置不当或依赖组件缺失。以下是解决此类问题的具体步骤：
本文运行环境：Dell XPS 13，Ubuntu 22.04
一、确认PHP和Redis服务正常运行
确保PHP环境和Redis服务器均已正确安装并处于运行状态。若任一服务未启动，集成将无法完成。
1、打开终端，执行 sudo systemctl status redis-server 查看Redis服务状态。
立即学习“PHP免费学习笔记（深入）”；
2、若服务未运行，使用 sudo systemctl start redis-server 启动Redis。
3、输入 php -v 验证PHP是否已安装且版本兼容（建议PHP 7.4及以上）。
二、安装PHP Redis扩展
PHP需通过redis扩展与Redis服务器通信。该扩展可通过pecl或系统包管理器安装。
1、更新软件包列表：sudo apt update。
2、安装php-redis扩展包：sudo apt install php-redis。
3、若使用pecl方式，先安装编译工具：sudo apt install php-dev，然后运行 sudo pecl install redis。
三、启用Redis扩展并检查配置
安装完成后需在PHP配置文件中启用redis.so模块，并验证是否成功加载。
1、查找php.ini文件位置：php --ini | grep "Loaded Configuration File"。
2、编辑php.ini文件，在末尾添加 extension=redis 或 extension=redis.so。
3、保存后重启Web服务器：sudo systemctl restart apache2（如使用Apache）。
四、测试PHP与Redis连接
创建一个PHP脚本测试Redis连接，以确认集成是否成功。
1、新建test_redis.php文件：nano test_redis.php。
2、写入以下内容：
<?php
$redis = new Redis();
if ($redis->connect('127.0.0.1', 6379)) {
echo "Connected to Redis successfully";
} else {
echo "Failed to connect to Redis";
}
?>
3、在浏览器或命令行访问该文件，观察输出结果。
五、排查权限与防火墙限制
某些情况下，SELinux策略或防火墙规则可能阻止PHP进程访问Redis端口。
1、检查本地连接是否被拒绝：telnet 127.0.0.1 6379。
2、若连接超时，确认Redis绑定地址是否为127.0.0.1或0.0.0.0，查看配置文件 /etc/redis/redis.conf 中的 bind 行。
3、如有必要，开放端口：sudo ufw allow 6379。
