Laravel Redis缓存怎么接入项目使用

冬伟吖_1450

冬伟吖_1450

2026-09-26

806人浏览

原创

cache_driver=redis生效需闭环验证三步:装对php redis扩展(phpredis或predis)、配准database.php与cache.php的redis连接名及环境变量、清缓存后用cache::store('redis')显式验证读写。

laravel redis缓存怎么接入项目使用

直接设 CACHE_DRIVER=redis 不等于缓存就走 Redis——多数项目卡在扩展没装、配置没对齐、命令没清缓存这三步上。真正生效必须闭环验证:装得对、配得准、调得通。

装好 PHP Redis 扩展

没有底层通信能力,Laravel 根本发不出 Redis 请求。

  • 用 php -m | grep redis 查看是否已加载 redis(phpredis)或无输出但 composer show predis/predis 有版本(Predis)
  • 若未安装 phpredis:运行 pecl install redis,并在 php.ini 加 extension=redis.so(Linux/macOS)或 extension=php_redis.dll(Windows)
  • 若选 Predis:执行 composer require predis/predis,同时确保 config/database.php 中 'client' => 'predis'
  • 改完重启 PHP-FPM 和 Web 服务(如 Nginx/Apache)

对齐 database.php 和 cache.php 配置

Laravel 缓存复用的是数据库配置里的 Redis 连接定义,不是独立一套。两处 key 必须一致,否则静默 fallback 到 file 驱动。

Redis Skill - 高性能缓存管理
Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载
  • 在 config/database.php 的 'redis' => ['connections' => [...]] 下,确认存在你打算用的连接名,例如:
    'cache' => [ 'host' => env('REDIS_HOST', '127.0.0.1'), 'password' => env('REDIS_PASSWORD', null), 'port' => env('REDIS_PORT', 6379), 'database' => env('REDIS_CACHE_DB', 1), ]
  • 在 config/cache.php 中,确保:
    'default' => env('CACHE_DRIVER', 'redis')
    且 'stores' => ['redis' => [ 'driver' => 'redis', 'connection' => 'cache', // 必须和 database.php 里定义的 key 一致 ]]
  • 环境变量 .env 要同步写全:
    CACHE_DRIVER=redis<br>REDIS_HOST=127.0.0.1<br>REDIS_PORT=6379<br>REDIS_PASSWORD=null<br>REDIS_CACHE_DB=1

清缓存并显式验证连通性

不执行 config:clear,新环境变量不会生效;不显式调用 store,可能还在走默认 file 驱动。

  • 运行 php artisan config:clear && php artisan config:cache
  • 进入 Tinker 验证:
    php artisan tinker
    Cache::store('redis')->put('health_test', 'ok', 30);
    Cache::store('redis')->get('health_test');
    返回 "ok" 表示 Redis 已通
  • 别依赖 Cache::get() —— 它走的是 config/cache.php 的 default store,而你刚配的是 redis store。显式写 Cache::store('redis')->get(...) 更可靠

日常使用与避坑提示

缓存写入简单,但几个细节错一点就白配。

  • 存数据用 Cache::store('redis')->put('key', $value, 3600),单位是秒;remember() 适合查库+缓存组合场景
  • 加前缀防 key 冲突:在 config/cache.php 的 stores.redis 下加 'prefix' => 'app_v1:'
  • 不要用 php artisan cache:clear 清 Redis 全库——它只清当前 store 指向的 database,不是 FLUSHALL;要清指定库,用 redis-cli -n 1 flushdb
  • 序列化问题:Eloquent 模型用 remember() 时若属性丢失,检查是否启用了 serialize(Laravel 9+ 默认开启),或手动 json_encode() 预处理

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

laravel redis redis缓存

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

817

10

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

2024.04.09

815

9

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

2408

10

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.10

3401

7

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

2025.08.05

4770

22

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

2025.08.05

3196

13

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.05

6089

7

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

2026.03.04

1356

29

Laravel 框架安装指南
Laravel 框架安装指南

本指南详解 Laravel 框架安装全流程,涵盖 PHP 8.1+ 环境配置、Composer 依赖管理工具安装及国内镜像源优化。重点演示使用 composer create-project 命令创建 Laravel 10/11 项目,解决常见安装错误与依赖冲突。从环境搭建到项目初始化,助您快速完成 Laravel 开发环境部署,为后续 Web 应用开发奠定基础。适合 PHP 初学者与框架迁移开发者参考。

2026.04.09

195

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 184人学习

Composer手册
Composer手册

共0课时 | 0人学习