PHP Redis扩展未加载是配置失败的主因，需用php -m | grep redis验证，检查php.ini中extension=redis.so、路径及依赖，并确认SELinux或防火墙未拦截连接。
确认 PHP 是否已加载 redis 扩展
很多配置失败的根源其实是 redis 扩展根本没装或没启用。运行 php -m | grep redis，如果没输出，说明扩展未生效。
常见情况包括：
– 编译安装 PHP 时没加 --enable-redis（已过时，现多用 pecl）
– php.ini 里漏了 extension=redis.so（Linux/macOS）或 extension=php_redis.dll（Windows）
– 扩展文件路径错误，或依赖的 igbinary 未同步加载
建议用 php --ini 确认实际加载的 php.ini 路径，然后在该文件末尾追加：
extension=redis.so
重启 Apache 后再验证 phpinfo() 页面中是否出现 Redis 模块信息。
立即学习“PHP免费学习笔记（深入）”；
Apache 不需要额外配置 Redis 连接
Apache 本身不参与 PHP 与 Redis 的通信，它只负责把请求交给 PHP 处理。Redis 连接完全由 PHP 代码控制，Apache 配置里不需要写任何 Redis 相关指令。
容易混淆的点：
– 不要试图在 httpd.conf 或虚拟主机里加 RedisHost 类似指令（不存在）
– 不需要修改 mod_php 或 php-fpm 的 Apache 模块配置来“支持 Redis”
– 如果用的是 PHP-FPM，Redis 连接行为仍由 PHP 脚本决定，FPM 只管进程管理
真正要检查的是 PHP 运行用户（如 www-data 或 _www）能否访问 Redis 服务：telnet 到 127.0.0.1 6379，或执行 php -r "new Redis(); $r->connect('127.0.0.1', 6379);" 测试连通性。
PHP 脚本中正确实例化 Redis 客户端
连接方式直接影响稳定性。别直接 new Redis() 后裸调 connect()，没异常捕获极易导致页面报错中断。
推荐写法：
$redis = new Redis();
try {
$redis->connect('127.0.0.1', 6379, 2.5); // 第三个参数是超时秒数
$redis->setOption(Redis::OPT_SERIALIZER, Redis::SERIALIZER_PHP);
} catch (RedisException $e) {
error_log('Redis connection failed: ' . $e->getMessage());
// 可降级到 file cache 或直接跳过缓存逻辑
}
注意：
– 生产环境避免用 SERIALIZER_PHP（兼容性差、有反序列化风险），改用 SERIALIZER_IGBINARY（需装 igbinary 扩展）或手动 json_encode/decode
– 不要用 pconnect() 在 Apache mod_php 下——每个请求都复用长连接反而易引发连接泄漏
– 若 Redis 开了密码，必须紧接着调用 $redis->auth('your_password')
检查 SELinux 或防火墙是否拦截本地连接
CentOS/RHEL 上 SELinux 默认会阻止 Apache 子进程（httpd）主动向外发起网络连接，即使目标是 127.0.0.1。
验证方法：
– 查看 sudo ausearch -m avc -ts recent | grep httpd 是否有 denied 记录
– 临时放行：sudo setsebool -P httpd_can_network_connect 1
其他限制点：
– Docker 容器内 PHP 连不到宿主机 Redis？试试用 host.docker.internal 或 --network host
– Redis 绑定到了 127.0.0.1 但 PHP 运行在另一个网络命名空间（如 LXC）？需确认网络可达性
– bind 配置在 redis.conf 中是否包含 127.0.0.1，且 protected-mode no 仅在可信内网开启
最常被忽略的是：开发时用 CLI 运行测试脚本成功，但浏览器访问就超时——八成是 SELinux 或 Apache 用户权限卡在了网络策略上。
