ThinkPHP5.1 redis 缓存配置文件怎么编写-ThinkPHP-PHP中文网

ThinkPHP 5.1 的 Redis 缓存配置必须写在 config/cache.php 中，返回严格结构的数组：type 必须为 'redis'（小写），host、port、password（空也需写''）、select（整数）缺一不可，否则静默失效。

thinkphp5.1 redis 缓存配置文件怎么编写

ThinkPHP 5.1 的 Redis 缓存配置必须写在 config/cache.php 文件中，不能放在 app.php 或其他配置文件里。这个文件需返回一个 PHP 数组，且结构要严格匹配框架要求——配错字段名、类型或缺失必填项，都会导致缓存静默失效（Cache::get() 返回 null，无报错提示）。

基础单驱动配置（推荐新手用）

适用于只使用 Redis 一种缓存的项目，简洁明确：

type 必须为 'redis'（全小写，大小写敏感）
host 和 port 必须显式写出，即使本地也别省略；Docker 环境注意改用 host.docker.internal 或宿主机 IP
password 即使为空，也要写 ''，不能省略或写 null
select 是整数（如 0），不能写字符串 "0"
prefix 建议设非空值（如 'tp51_'），避免多项目共用 Redis 时键冲突
expire 单位是秒；0 表示永不过期，但生产环境慎用；建议设为正整数（如 3600）

示例 config/cache.php：

return [
  'type'    => 'redis',
  'host'    => '127.0.0.1',
  'port'    => 6379,
  'password' => '',
  'select'   => 0,
  'prefix'  => 'tp51_',
  'expire'  => 3600,
];

复合缓存配置（支持多 store 切换）

适合需要同时用 File（调试）和 Redis（线上）的场景，通过 Cache::store('redis') 显式调用：

redis-tools

按类别查找Redis命令、检测服务器连接、监控键数量和内存占用，支持离线速查表。

下载

顶层 'type' 必须为 'complex'
'default' 指定默认 store 名（如 'redis'），否则 Cache::set() 会走 file 或空实现
每个 store（如 'redis'、'file'）必须独立定义完整参数，不能复用顶层字段
Redis store 内仍需包含 'host'、'port'、'password'、'select' 等全部连接项

示例：

return [
  'type'  => 'complex',
  'default' => 'redis',
  'stores' => [
    'redis' => [
      'type'    => 'redis',
      'host'    => '127.0.0.1',
      'port'    => 6379,
      'password' => '',
      'select'   => 0,
      'prefix'  => 'tp51_redis_',
      'expire'  => 3600,
    ],
    'file' => [
      'type' => 'file',
      'path' => '../runtime/cache/',
      'prefix' => 'tp51_file_',
      'expire' => 3600,
    ],
  ],
];

关键验证点（写完必须检查）

配置不是保存就完事，这几项不确认，缓存大概率不工作：

PHP 是否已加载 redis 扩展？运行 php -m | grep redis 验证
Redis 服务是否正在运行？可执行 redis-cli ping 看是否返回 PONG
键名是否合法？避免空格、中文、斜杠；建议统一用 md5($key) 或仅含字母数字下划线
调用方式是否匹配配置？若用了 Cache::store('redis')，但配置里没定义 'redis' 这个 store 名，就会 fallback 到默认（可能是 file）
开发时临时加 'timeout' => 3（单位秒），防止 Redis 不可用时请求卡死