Laravel中如何配置Redi缓存_Laravel使用Redi环境搭建与连接【详解】

Redis服务是否已启动并可被Laravel访问？需先验证Redis进程运行及网络连通性，再确认.env中CACHE_DRIVER=redis等配置正确、config/cache.php匹配，最后清理配置缓存并检查实际驱动是否为redis。

Redis 服务是否已启动并可被 Laravel 访问

很多“连接失败”其实不是 Laravel 配置问题，而是 Redis 服务根本没跑起来，或 Laravel 所在环境（比如 Docker 容器、Homestead、云服务器）连不到 127.0.0.1:6379。先确认基础连通性：

• 在 Laravel 项目根目录运行：复制AI写代码

  1 2	php artisan tinker >>> Redis::ping()

  ，若报错 Connection refused，说明 Redis 进程未运行或端口被占
• 用命令行直连测试：复制AI写代码

  1	redis-cli -h 127.0.0.1 -p 6379 ping

  ，返回 PONG 才算通
• Docker 环境下，Laravel 容器不能用 127.0.0.1 访问宿主机 Redis；应改用宿主机 IP（如 172.17.0.1）或 Docker 网络别名（如 redis）

如何正确配置 .env 和 cache.php

Laravel 的 Redis 缓存依赖两个地方：环境变量控制连接参数，config/cache.php 控制驱动与默认 store。常见错误是只改了 .env 却忘了 CACHE_DRIVER=redis，或误以为改了 REDIS_HOST 就自动生效。

• .env 中必须包含以下几项（按需调整值）：复制AI写代码

  1 2 3 4 5

  REDIS_HOST=127.0.0.1 REDIS_PASSWORD=null REDIS_PORT=6379 REDIS_DB=0 CACHE_DRIVER=redis

• config/cache.php 中的 default => redis 必须匹配 stores.redis 配置段；若使用哨兵或集群，需额外配置 options => [cluster => redis] 并改写 redis store 的 client 为 predis 或 phpredis
• 修改 .env 后务必清缓存：复制AI写代码

  1	php artisan config:clear

  ，否则旧配置仍被加载

为什么 Cache::get() 返回 null，但 Redis CLI 能查到 key

这通常不是连接问题，而是 Laravel 默认给所有缓存 key 加了前缀（laravel_database_），且使用了序列化协议。直接用 redis-cli get xxx 查不到，是因为 key 名不一致，且值是 PHP 序列化后的二进制数据。

• 查看真实 key：在 tinker 中执行 复制AI写代码

  1	Cache::store(redis)->get(my_key)

  ，再用 redis-cli keys "*my_key*" 搜索带前缀的 key
• 避免混淆：开发时可在 config/database.php 的 redis.default.prefix 设为空字符串（），但生产环境不建议
• 如果用 phpredis 扩展，注意它默认不支持 unserialize，需在 redis store 配置中显式设置 options => [serializer => php]

如何验证 Redis 缓存是否真正生效

光看 Cache::put() 不报错不代表写入成功；要确认读写路径走的是 Redis，而不是 fallback 到 file 或 array 驱动。

• 临时加日志：在 config/cache.php 的 redis store 中加入 connection => default，然后在 tinker 中运行：复制AI写代码

  1 2	Cache::store(redis)->put(test_key, test_value, 60); Cache::store(redis)->get(test_key);

  ，同时用 redis-cli monitor 观察是否有 SET 和 GET 命令发出
• 检查实际使用的驱动：复制AI写代码

  1	Cache::getStore()->getDriverName()

  应返回 redis，而非 file 或 array
• 留意 phpinfo() 中是否启用了 redis 或 phpredis 扩展；仅安装 predis/predis Composer 包不够，某些操作（如 pipeline、Lua 脚本）仍需原生扩展支持

Redis 缓存是否生效，关键不在配了多少行，而在每一步是否真正落到 socket 连接和 Redis 协议层面。跳过连通性验证、忽略前缀和序列化、不清理 config 缓存——这三个动作最容易让配置看起来“对了”，实则完全没走 Redis。