Phpfastcache 6.1.4 Redis配置异常：如何正确配置Redis？

1. 确认PHP Redis扩展已安装 #

phpFastCache v6不再依赖第三方Redis客户端库，但必须依赖PHP原生的redis扩展（非predis）。

• 在PHP容器内执行命令检查扩展是否存在：

  php -m | grep redis
  

• 若无输出，需在PHP镜像的Dockerfile中添加安装步骤：
  • Debian/Ubuntu基础镜像：

    apt-get update && apt-get install -y php-redis
    

  • Alpine基础镜像：

    apk add php-redis
    

  • 源码编译场景：

    pecl install redis && docker-php-ext-enable redis
    

2. 修正Redis连接地址（Kubernetes环境关键） #

Kubernetes中Redis作为独立Service部署，PHP容器内的localhost无法访问外部Redis服务，需将配置中的host替换为Redis Service的名称：

• 假设Redis Service名称为redis-service，修改config.php：

  return [
      'driver' => 'redis',
      'maxRetries' => 3,
      'config' => [
          'defaultTtl' => 900,
          'host' => 'redis-service', // 替换为你的Redis Service名称
          'port' => 6379,
          'database' => 11,
          'password' => 'your-redis-password',
          'timeout' => 3,
      ],
  ];
  

• 若Redis与PHP不在同一Namespace，需使用完整域名：redis-service.your-namespace.svc.cluster.local

3. 验证Redis连接参数有效性 #

• 密码校验：确保password与Redis配置文件中的requirepass值完全一致
• 数据库编号：Redis默认提供0-15共16个数据库，11为合法编号，需确认Redis未限制该数据库的访问权限
• 超时时间：3秒为合理值，若网络延迟较高可适当调整

4. 测试PHP容器与Redis的连通性 #

在PHP容器内使用redis-cli直接测试连接，排除网络或Redis服务问题：

# 替换为你的Redis Service名称和密码
redis-cli -h redis-service -p 6379 -a "your-redis-password" select 11

• 若命令返回OK，说明网络和Redis服务正常；若失败，需排查：
  • Redis Service的端口是否正确映射为6379
  • Redis配置文件中bind是否设为0.0.0.0（允许所有IP访问）
  • Redis是否开启了密码验证且密码正确

5. 简化配置快速验证 #

暂时移除非必要配置参数，使用最简配置测试是否能正常连接：

return [
    'driver' => 'redis',
    'config' => [
        'host' => 'redis-service',
        'port' => 6379,
        'password' => 'your-redis-password',
        'database' => 11,
    ],
];

若最简配置能正常运行，再逐步添加maxRetries、defaultTtl、timeout等参数。

内容的提问来源于stack exchange，提问作者user3552178