【PHP】Last-Modifiedヘッダによる静的コンテンツのキャッシュ制御

画像などの静的コンテンツのファイルに直接アクセスした場合は
ブラウザが自動的にキャッシュ制御を行ってくれますが、
PHPで静的コンテンツを返すような処理を行っている場合にキャッシュを利用するには
Last-Modifiedヘッダを使ってキャッシュを制御する必要があります。

まず、PHPでファイルをダウンロードさせる際に
filemtime関数でファイルの更新日時を取得してLast-Modifiedヘッダを追加します。

header('Last-Modified: filemtime('ファイルのパス'));

1	header('Last-Modified: filemtime('ファイルのパス'));

さらにキャッシュを残すためのヘッダも追加します。

header('Pragma: cache');
header("Cache-Control: max-age=" . (60 * 60 * 24 * 30)); // 有効期間30日の例

1 2	header('Pragma: cache'); header("Cache-Control: max-age=" . (60 * 60 * 24 * 30)); // 有効期間30日の例

そうすると、次に同じファイルをダウンロードしようとした際のリクエストヘッダの中に

HTTP_IF_MODIFIED_SINCE

1	HTTP_IF_MODIFIED_SINCE

というヘッダが追加され、ファイルの更新日時が入っています。

ですので、このヘッダの有無を調べ、ファイルの更新日時と比較することで
ファイルを返すかキャッシュを返すかを判定します。

$filelastmodified = filemtime('ファイルのパス');
if(isset($_SERVER["HTTP_IF_MODIFIED_SINCE"])){
  $headerlastmodified = $_SERVER["HTTP_IF_MODIFIED_SINCE"];
  if(strtotime($headerlastmodified == strtotime($filelastmodified)){
    // 更新日が一致したのでキャッシュを返す
    // （正しくはレスポンスコード304を返す）
  }
  else {
    // ファイルを返す
  }
}

$filelastmodified = filemtime('ファイルのパス');

if(isset($_SERVER["HTTP_IF_MODIFIED_SINCE"])){

$headerlastmodified = $_SERVER["HTTP_IF_MODIFIED_SINCE"];

if(strtotime($headerlastmodified == strtotime($filelastmodified)){

// 更新日が一致したのでキャッシュを返す

// （正しくはレスポンスコード304を返す）

}

else {

// ファイルを返す

}

レスポンスコード304を返す処理は下記の通りです。

header("HTTP/1.1 304 image not modified");
header('Pragma: cache');
header("Cache-Control: max-age=" . (60 * 60 * 24 * 30));

header("HTTP/1.1 304 image not modified");

header('Pragma: cache');

header("Cache-Control: max-age=" . (60 * 60 * 24 * 30));

ちなみに、Etagというヘッダを使ってキャッシュを制御することもできますが
Etagはどちらかというと動的コンテンツのキャッシュで利用するためのものです。
静的コンテンツのキャッシュにもEtagを使ったサンプルが多くみられるのですが
Last-Modifiedヘッダだけで十分だと思います。

関連記事