在使用 laravel 開發網站或應用程序時,經常會使用靜態文件來提高網站的性能和用戶體驗。這些靜態文件通常包括 css、JavaScript、圖片和字體等等。但是在開發過程中,經常會遇到修改靜態文件后,瀏覽器仍然使用原來的緩存文件,導致網站出現問題的情況。因此,在這篇文章中,我們將談論 laravel 靜態文件的緩存清除方法,以便您可以在修改靜態文件后立即看到效果。
原理
首先,讓我們看看瀏覽器如何緩存靜態文件。瀏覽器會為發起的靜態文件請求創建一個標識符 (ETag),然后將此標識符與靜態文件一起保存到緩存中。每次瀏覽器再次請求相同的文件時,它將向服務器發送該文件的標識符,并使用該標識符驗證緩存。如果標識符匹配,瀏覽器將從緩存中提取文件。
雖然瀏覽器緩存是在用戶電腦本地完成的,但在 Laravel 應用程序中,我們可以通過更改靜態文件的 URL 或添加其它查詢參數來干擾瀏覽器緩存。這意味著每次修改靜態文件時,我們可以更改其 URL 或添加查詢參數,以確保瀏覽器會獲取新的文件,而不是使用緩存的舊文件。
接下來,我們將看到如何實現這一目標。
Laravel 靜態文件緩存清除方法
方法一:手動更改 URL 或添加查詢參數
手動更改靜態文件的 URL 或添加查詢參數是一種簡單的緩存清除方法。例如,我們可以在引用 CSS 文件時,將其 URL 更改為:
<link rel="stylesheet" href="style.css?v=1">
這會告訴瀏覽器請求該文件時,添加 ?v=1 作為查詢參數。如果我們想更新文件,可以將查詢參數更改為 ?v=2 或任何其他值。每次修改文件時,都需要更新 URL 或添加新的查詢參數。
盡管這種方法相對簡單,但需要手動更新每個文件的 URL 或添加查詢參數,非常費時費力。
方法二:使用 Mix 和版本控制
Laravel Mix 是 Laravel 的一個前端構建工具,它允許您使用許多流行的前端工具來編譯、壓縮和打包 CSS、JavaScript、圖片和字體等文件。Mix 可以幫助您自動生成靜態文件 URL,并在每次構建時更改版本號,以確保瀏覽器獲取最新的文件。
要使用 Mix,我們需要先安裝 Laravel Mix:
npm install laravel-mix --save-dev
然后,在 webpack.mix.JS 文件中定義靜態文件和版本:
mix.js('resources/js/app.js', 'public/js') .sass('resources/sass/app.scss', 'public/css') .version();
運行 npm run dev 或 npm run prod 可以生成具有版本號的文件。例如,如果我們編譯 app.css 文件,它將生成 app.css?id=48d24b 文件,其中 48d24b 是文件的哈希值。每次修改文件時,Laravel Mix 將使用新的哈希值生成新的版本。
要在 html 文件中使用 Mix 生成的靜態文件 URL,可以使用以下代碼:
<link rel="stylesheet" href="{{ mix('css/app.css') }}">
這會自動將文件名轉換為帶有版本號的文件名。例如,如果我們運行 npm run prod,則上面的代碼將生成以下結果:
<link rel="stylesheet" href="/css/app.css?id=48d24b">
通過使用 Laravel Mix,我們無需手動更改文件的 URL 或添加查詢參數。Laravel Mix 將自動為我們生成新的版本號,并更改靜態文件的 URL。
方法三:使用緩存清除中間件
Laravel 緩存清除中間件允許我們在每次請求時清除瀏覽器緩存。要使用緩存清除中間件,我們可以在 app/http/Middleware/CacheControl.php 中創建以下代碼:
<?php namespace AppHttpMiddleware; use Closure; class CacheControl { public function handle($request, Closure $next) { $response = $next($request); $response->header('Cache-Control', 'nocache, no-store, max-age=0, must-revalidate'); $response->header('Pragma', 'no-cache'); $response->header('Expires', 'Fri, 01 Jan 1990 00:00:00 GMT'); return $response; } }
然后,在 app/Http/Kernel.php 中注冊中間件:
protected $middleware = [ // ... AppHttpMiddlewareCacheControl::class, ];
現在,每次瀏覽器請求靜態文件時,它將向服務器發送一個新的請求,而不是使用緩存,確保我們始終獲得最新的文件。
總結
通過手動更改靜態文件的 URL 或添加查詢參數,使用 Laravel Mix 或使用緩存清除中間件,我們可以有效地清除 Laravel 應用程序中的緩存文件,并確保用戶始終看到最新的內容。
嘗試不同的方法,并選擇最適合您需要的方法來管理靜態文件的緩存清除。無論使用哪種方法,都應該時刻注意緩存的影響,以確保您的網站始終保持良好性能和用戶體驗。