laravel blade 模板支持四种缓存机制:一、用 @cache 指令(需安装扩展包);二、手动结合 cache 门面与 php 代码;三、用 cache::remember 封装渲染逻辑;四、启用全局视图编译缓存(view:cache 命令)。

如果您希望在 Laravel 的 Blade 模板中对部分动态内容进行缓存以减少重复渲染或数据库查询,可采用多种机制实现。以下是解决此问题的步骤:
一、使用 Blade Cache Directive 扩展包的 @cache 指令
该方法通过引入第三方扩展包,提供声明式语法,在模板中直接标记需缓存的片段,底层调用 Laravel 缓存驱动(如 file、redis),支持 TTL 设置与动态键生成。
1、执行 Composer 命令安装扩展包:composer require ryangjchandler/blade-cache-directive
2、发布配置文件(可选,用于自定义默认 TTL 或禁用):php artisan vendor:publish --provider="RyanChandler\BladeCacheDirective\BladeCacheDirectiveServiceProvider"
3、在 Blade 模板中使用 @cache 指令包裹目标内容:@cache('sidebar_menu', 3600) @include('partials.sidebar') @endcache
4、支持基于模型 ID 的动态缓存键:@cache("user_profile_{$user->id}") {{ $user->bio }} @endcache
二、手动结合 Cache 门面与 Blade 原生 PHP 代码
该方法不依赖额外包,利用 Blade 允许嵌入原生 PHP 的特性,显式调用 Cache::get() 与 Cache::put() 控制片段缓存逻辑,适用于需精细控制缓存条件或 fallback 行为的场景。
1、在 Blade 模板中插入 PHP 代码块判断缓存是否存在:@php $cachedContent = IlluminateSupportFacadesCache::get('latest_posts'); @endphp
2、若缓存命中则直接输出,否则执行耗时操作并写入缓存:@if($cachedContent) {!! $cachedContent !!} @else @php $content = view('partials.posts')->render(); IlluminateSupportFacadesCache::put('latest_posts', $content, 1800); echo $content; @endphp @endif
三、使用 Cache::remember 方法封装渲染逻辑
该方法将缓存读取与写入合并为原子操作,避免条件竞争,适合缓存视图片段渲染结果,且自动处理未命中时的生成与存储。
1、在控制器中预先计算并传递缓存内容(推荐):$data['cached_banner'] = Cache::remember('homepage_banner', 7200, function () { return view('partials.banner')->render(); });
2、或在 Blade 中内联调用(需确保上下文可访问 Cache 门面):{{ IlluminateSupportFacadesCache::remember('footer_links', 3600, function () { return view('partials.footer-links')->render(); }) }}
四、启用全局视图编译缓存(view:cache 命令)
该方法缓存的是 Blade 模板编译后的 PHP 文件,而非运行时渲染结果,适用于生产环境固定视图结构的场景,能跳过每次请求的模板解析与编译开销。
1、执行 Artisan 命令生成编译缓存:php artisan view:cache
2、确认缓存文件已写入 storage/framework/views/ 目录,且文件权限允许 Web 服务器读取
3、修改任何 .blade.php 文件后,必须重新运行该命令,否则变更不会生效
4、开发阶段应禁用此功能,避免出现 “改了模板但页面没变” 的调试陷阱











