PHP實現RESTful API緩存控制：提升性能的最佳實踐

gitbox 2025-07-30

什麼是RESTful API的緩存控制

RESTful API是一種基於HTTP協議實現的接口風格，它將資源的標識符和資源的狀態分離開來，使客戶端和服務端的交互更加簡便。在使用RESTful API的過程中，緩存對性能優化具有重要的作用。緩存控制指的是在服務端通過設置HTTP頭來告訴客戶端如何緩存和使用緩存。

RESTful API緩存控制的HTTP頭

HTTP頭是HTTP請求和響應的一部分，它包含了關於響應內容、緩存控制、身份驗證等信息。在RESTful API緩存控制中，常用的HTTP頭有：

Cache-Control

Cache-Control是HTTP/1.1中新增的一個指令，用來控制客戶端請求、代理服務器緩存和服務端響應的緩存行為。常見的取值如下：

public ：響應可以被任何中間人（例如代理服務器）緩存。
private ：響應只能被單個用戶（例如瀏覽器緩存）緩存。
no-cache ：表示客戶端和所有緩存都必須先向服務端驗證緩存的有效性，不能直接使用緩存。
no-store ：表示響應不能被緩存。
s-maxage ：代理服務器緩存生存時間，優先級高於max-age。
max-age ：響應被緩存的時間（秒），超過這個時間會被認為過期。

ETag

ETag是HTTP響應頭中的一個實體標籤，用於標識出當前資源的狀態。客戶端在請求時通過If-None-Match頭將之前獲取的ETag值發送給服務端，服務端比較ETag值是否一致，如果一致則返回304 Not Modified響應，客戶端可以直接使用緩存。

Last-Modified

Last-Modified是HTTP響應頭中的一個日期時間值，用於標識出當前資源的最後修改時間。客戶端在請求時通過If-Modified-Since頭將之前獲取的日期時間值發送給服務端，服務端比較日期時間是否一致，如果一致則返回304 Not Modified響應，客戶端可以直接使用緩存。

在PHP中實現RESTful API的緩存控制

在PHP中實現RESTful API緩存控制，可以通過設置HTTP頭信息來實現。

設置Cache-Control頭

可以在服務端通過header函數設置Cache-Control頭，代碼如下：

 
$maxAge = 600; // 快取600秒
header('Cache-Control: public, max-age=' . $maxAge);

上述代碼設置了Cache-Control頭為public，表示響應可以被任何中間人（例如代理服務器）緩存，並且最長緩存時間為600秒。

設置ETag頭

可以在服務端通過header函數設置ETag頭，代碼如下：

 
$etag = md5($responseBody); // 根據響應內容生成實體標籤
header('ETag: ' . $etag);

上述代碼根據響應內容生成了一個ETag標籤，並將其設置為響應頭的一部分。

設置Last-Modified頭

可以在服務端通過header函數設置Last-Modified頭，代碼如下：

 
$lastModifiedTime = filemtime($filePath); // 獲取文件的最後修改時間
$lastModified = gmtdate('r', $lastModifiedTime);
header('Last-Modified: ' . $lastModified);

上述代碼獲取了文件的最後修改時間，並將其轉換成了GMT格式，然後將其設置為響應頭的一部分。

總結

RESTful API的緩存控制能夠大大提升應用的性能，減少對服務端資源的請求和響應。在實現RESTful API的緩存控制時，我們可以通過設置HTTP頭來告訴客戶端如何緩存和使用緩存。 HTTP頭包括了Cache-Control、ETag和Last-Modified等重要的信息，客戶端可以通過這些信息來判斷是否可以直接使用緩存響應。