什么是模板缓存？

模板缓存就是 Laravel 将你写的 Blade 模板文件（.blade.php）预先编译成纯 PHP 代码，并将这个编译后的 PHP 文件保存到缓存目录中。

laravel模板缓存
（图片来源网络，侵删）

在后续的请求中，Laravel 不会再去解析和编译你的 Blade 语法，而是直接执行这个已经编译好的 PHP 文件，由于 PHP 代码的执行效率远高于解释和编译 Blade 模板的过程,这能显著提升应用的响应速度。

为什么需要模板缓存？

Blade 模板引擎非常强大，它允许你使用模板继承、组件、包含等高级语法，但这些语法的实现需要在每次请求时进行解析和编译,这会带来一定的性能开销。

模板缓存的主要目的就是消除这个编译开销，从而提升应用的性能和响应速度。 对于高流量的网站来说,这是一个简单且效果显著的优化手段。

模板缓存是如何工作的？

  1. 首次请求：当一个用户第一次访问一个使用 Blade 模板的页面时，Laravel 的 Blade 编译器会找到对应的 .blade.php 文件。
  2. 编译：编译器会将 Blade 语法（如 @if, @foreach, {{ $variable }}）转换成原生的 PHP 代码。
  3. 缓存：编译后的 PHP 代码会被保存到 storage/framework/views 目录下的一个文件中，这个文件名通常是经过哈希处理的,以确保唯一性。
  4. 后续请求：当其他用户（或同一个用户）再次访问这个页面时，Laravel 会首先检查 storage/framework/views 目录中是否存在对应的编译缓存文件。
    • 如果存在：Laravel 会直接执行这个缓存文件，跳过编译步骤,速度极快。
    • 如果不存在（你修改了原始模板文件）：Laravel 会重新执行上述的编译和缓存过程。

如何使用和管理模板缓存？

Laravel 提供了几个非常方便的 Artisan 命令来管理模板缓存。

laravel模板缓存
（图片来源网络，侵删）

清除缓存

当你修改了 Blade 模板文件后，必须清除旧的缓存文件，这样 Laravel 才会知道需要重新编译,这是最常见的操作。

# 清除所有已编译的视图模板
php artisan view:clear

编译所有视图

如果你刚刚部署了新代码，或者想确保所有模板都已经被预编译，可以使用这个命令，它会遍历 resources/views 目录下的所有模板文件,并将它们全部编译到缓存中。

# 编译所有视图模板
php artisan view:compile

这个命令在部署脚本中非常有用,可以确保线上环境在接收流量之前就已经完成了所有模板的预编译。

清除所有缓存

这是一个更广泛的“清除”命令，它会清除框架生成的所有缓存，包括路由缓存、配置缓存等，当你进行重大更新后,通常会使用这个命令。

laravel模板缓存
（图片来源网络，侵删）
# 清除所有框架缓存
php artisan cache:clear

注意：cache:clear 会清除应用缓存，而 view:clear 只清除视图缓存，视图缓存文件也位于 storage/framework/cache/data 目录下，cache:clear 也会一并清除它们。

最佳实践和注意事项

在生产环境中启用缓存

默认情况下，Laravel 在生产环境（APP_ENV=production）中是自动启用模板缓存的,你不需要做任何额外配置。

在开发环境（APP_ENV=local）中，Laravel 默认是不启用缓存的，这样做是为了在你修改模板文件后，能够立即看到效果，而无需手动运行 view:clear 命令。

部署流程中的最佳实践

一个典型的现代化部署流程应该包含编译视图的步骤：

  1. 拉取最新代码 (e.g., git pull)
  2. 安装/更新依赖 (e.g., composer install --no-dev)
  3. 优化自动加载 (e.g., composer dump-autoload --optimize)
  4. 配置缓存 (e.g., php artisan config:cache)
  5. 路由缓存 (e.g., php artisan route:cache)
  6. 编译视图 (e.g., php artisan view:compile) <-- 关键步骤
  7. 执行数据库迁移 (e.g., php artisan migrate --force)
  8. 重启队列/Worker (e.g., php artisan queue:restart)

将 php artisan view:compile 放在部署脚本中，可以确保你的服务器在上线前就完成了所有模板的预编译,从而获得最佳的性能。

何时需要手动清除缓存？

除了部署,以下情况也需要手动清除视图缓存：

  • 你修改了任何 Blade 模板文件后。
  • 你修改了 resources/views 目录下的文件结构。
  • 你在代码中动态地创建了新的 Blade 视图（这种情况较少见）。

缓存文件位置

编译后的视图缓存文件默认存储在： storage/framework/views

你可以通过修改 config/view.php 文件中的 paths 和 compiled 配置来更改这个位置。

// config/view.php
'paths' => [
    resource_path('views'),
],
'compiled' => storage_path('framework/views'), // 默认位置
特性 描述
目的 提升 Web 应用性能，减少每次请求对 Blade 模板的解析和编译开销。
工作原理 将 .blade.php 文件预编译为原生 PHP 文件并缓存，后续请求直接执行缓存文件。
生产环境 默认启用，部署时应使用 php artisan view:compile 预编译所有模板。
开发环境 默认禁用，修改模板后无需手动清除即可看到效果。
核心命令 php artisan view:clear (清除单个/所有视图缓存)
php artisan view:compile (编译所有视图)
自动失效 当原始的 .blade.php 模板文件被修改时，对应的缓存文件会自动失效，并在下次请求时被重新编译。

Laravel 的模板缓存是一个强大且自动化的性能优化工具，理解其工作原理并在你的开发和部署流程中正确使用它，将有助于构建出更快、更高效的 Web 应用。