Laravel5.5缓存功能到底应该如何开启使用

浅萱酱_1600

浅萱酱_1600

2026-06-29

307人浏览

原创

laravel缓存驱动必须通过.env中cache_driver=redis显式启用,仅改config/cache.php无效;需同步配置redis连接参数、执行config:clear与config:cache,并用cache::store('redis')->put()验证连通性。

laravel5.5缓存功能到底应该如何开启使用

缓存驱动必须在 .env 里配对生效

只改 config/cache.php 不起作用,Laravel 5.5 的缓存驱动由 CACHE_DRIVER 环境变量决定,它才是开关。不设这个值,哪怕 Redis 已装好、配置写得再全,Cache::get() 也默认走 file 驱动。

常见错误现象:本地开发时 Redis 连接正常,但 Cache::put('test', 'ok', 60) 写进去后查不到——其实是写到了 storage/framework/cache/ 目录下,不是 Redis。

  • .env 中必须明确设置:CACHE_DRIVER=redis(生产)或 CACHE_DRIVER=file(开发)
  • 若用 Redis,还需确认 REDIS_HOST、REDIS_PORT、REDIS_PASSWORD 正确,且 config/database.php 中 redis.default.database 值与实际 Redis DB 编号一致(默认是 0)
  • config/cache.php 中的 'default' 键只是 fallback,真正生效的是 .env 里的 CACHE_DRIVER

Cache::remember() 默认缓存 null 是个坑

直接用 Cache::remember('users', 30, function () { return DB::table('users')->first(); }),如果数据库没查到数据,返回 null,这个 null 会被原样缓存 30 分钟。之后所有请求都走缓存、直接返回 null,形成缓存穿透。

这不是 Laravel 的 bug,而是设计如此——remember 只管“执行回调 + 存结果”,不区分结果真假。

laravel-specialist
laravel-specialist

精通 Laravel 10+,遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载
  • 安全写法:显式判断查询结果,只缓存非空值:$user = DB::table('users')->first(); return $user ? Cache::put('users', $user, 30) : null;
  • 或者用短时效空标记:if (!$user = Cache::get('users')) { $user = DB::table('users')->first(); if ($user) { Cache::put('users', $user, 30); } else { Cache::put('users:miss', true, 60); } }
  • 读取时先检查空标记:if (Cache::has('users:miss')) { return null; }

php artisan cache:clear 清的不是你想象的“全部”

运行 php artisan cache:clear 默认只清当前 default store,也就是 CACHE_DRIVER 指定的那个驱动下的数据。如果你同时用了 redis 和 file 两个 store,它不会清 file 的缓存。

更隐蔽的问题:Redis 驱动下,cache:clear 实际执行的是 FLUSHDB,只清当前 database(比如 database => 0),但如果你把 Session 也放在同一个 Redis DB(比如 database => 0),这一命令会把所有用户踢下线。

  • 清指定 store:php artisan cache:clear --store=redis 或 php artisan cache:clear --store=file
  • 彻底清 Redis 当前 DB:redis-cli -h 127.0.0.1 -p 6379 -n 0 FLUSHDB(注意 -n 0 对应 config 中的 database 值)
  • 避免 Session 被连带清除:务必让 Session 和 Cache 使用不同 Redis DB,比如 Cache 用 database => 0,Session 用 database => 1

路由缓存和配置缓存不能共存于开发环境

php artisan route:cache 和 php artisan config:cache 都会生成静态 PHP 文件(routes-v7.php 和 config.php),它们跳过原始文件解析,大幅提升性能,但也带来硬性限制:一旦缓存生成,.env 修改、配置文件增删、路由文件改动都不会实时生效。

开发阶段频繁改路由或配置时,这两个命令反而成为障碍,不是“开了就更快”,而是“开了就不能热更新”。

  • 仅在部署后执行:php artisan route:cache 和 php artisan config:cache 应该放进 CI/CD 脚本,而不是本地开发流程
  • 改了 routes/web.php 后必须先 php artisan route:clear,否则新路由永远不生效
  • config:cache 失败常见原因:配置文件里写了闭包、调用了 app() 或未加载类、.env 有语法错误(如漏引号、中文等号)
实际项目中,缓存逻辑越靠近业务层,越容易忽略驱动隔离、空值处理、清除边界这些细节。尤其当多个团队共用一套 Redis 实例时,database 编号错配、cache:clear 意外清掉 Session,都是线上事故高频原因。

相关文章

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

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

下载

相关标签:

laravel

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

相关专题

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

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

2024.04.09

857

10

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

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

2024.04.09

835

9

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

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

2024.04.09

2488

10

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

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

2024.04.10

4161

7

laravel入门教程
laravel入门教程

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

2025.08.05

5970

22

laravel实战教程
laravel实战教程

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

2025.08.05

3956

13

laravel面试题
laravel面试题

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

2025.08.05

7429

7

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

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

2026.03.04

1436

29

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

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

2026.04.09

215

6

热门下载

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

精品课程

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

共1课时 | 208人学习

Composer手册
Composer手册

共0课时 | 0人学习