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

游戏科技网2026年09月14日 21:52云服务器90

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

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

在 Laravel 项目根目录运行：
1
2
php artisan tinker
>>> Redis::ping()
，若报错 Connection refused，说明 Redis 进程未运行或端口被占
用命令行直连测试：
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）

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

word-document-organizer

智能整理Word文档，自动排版、生成目录、统一样式，支持学术/商务/极简模板。

下载

.env 中必须包含以下几项（按需调整值）：
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 后务必清缓存：
1
php artisan config:clear
，否则旧配置仍被加载

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

查看真实 key：在 tinker 中执行
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]

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

临时加日志：在 config/cache.php 的 redis store 中加入 connection => default，然后在 tinker 中运行：
1
2
Cache::store(redis)->put(test_key, test_value, 60);
Cache::store(redis)->get(test_key);
，同时用 redis-cli monitor 观察是否有 SET 和 GET 命令发出
检查实际使用的驱动：
1
Cache::getStore()->getDriverName()
应返回 redis，而非 file 或 array
留意 phpinfo() 中是否启用了 redis 或 phpredis 扩展；仅安装 predis/predis Composer 包不够，某些操作（如 pipeline、Lua 脚本）仍需原生扩展支持

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