導入
Webサイトのブログや管理画面において、「月別アーカイブ」はユーザーの回遊性を高めるために不可欠な機能です。しかし、日付の計算はうるう年や月の末日の変動など、考慮すべき点が多く、バグを生みやすい箇所でもあります。本記事では、PHP標準のDateTimeクラスを使用し、堅牢でメンテナンス性の高いカレンダー生成ロジックを解説します。
基礎知識
PHPにおける日付操作の要は「DateTimeクラス」です。従来使われていたmktimeやdate関数よりも直感的に操作でき、タイムゾーンの管理や加減算が容易に行えます。特に、フォーマット文字「t」（その月の日数）や「w」（曜日を数値で取得）を活用することで、複雑な条件分岐を最小限に抑えることが可能です。
実装/解決策
カレンダーを構築する際のポイントは、「1日の曜日」を起点に、その月の末日までをグリッド状に配置することです。今回は実務で扱いやすいように、42マス（7日×6週間）の固定枠で生成する手法を採用します。これにより、表示崩れを防ぎつつ、カレンダーのレイアウトを安定させることができます。
サンプルプログラム
以下は、指定した年月のカレンダーを生成するコードです。クラス化や関数化を行うことで、ビュー側から呼び出しやすくしています。
/
function generateCalendarHtml($year, $month) {
// DateTimeオブジェクトで対象月の1日を設定
$date = new DateTime(“{$year}-{$month}-01”);
// その月の最終日を取得 (t)
$lastDay = (int)$date->format(‘t’);
// 1日の曜日を取得 (0:日, 1:月… 6:土)
$startDayOfWeek = (int)$date->format(‘w’);
$html = ‘
| 日 | 月 | 火 | 水 | 木 | 金 | 土 |
|---|---|---|---|---|---|---|
| – | ||||||
| {$day} | – |
‘;
return $html;
}
// 実行例：2023年10月のカレンダーを表示
echo generateCalendarHtml(2023, 10);
?>
応用・注意点
1. リンクの付与：
実務では「-」の部分にリンクを埋め込む必要があります。`if`文の中で、投稿が存在する日付かどうかをデータベースに問い合わせるロジックを追加してください。その際、N+1問題を避けるため、対象月の記事データを事前に配列等で取得し、`in_array`などで判定するのが効率的です。
2. セキュリティ：
外部からのパラメータ（$_GET[‘year’]など）を受け取る場合は、必ず`intval()`でキャストし、存在しない月（13月など）が指定された場合に例外処理を行うか、現在日時へフォールバックさせる実装が必須です。
3. タイムゾーン：
サーバーの環境によってデフォルトタイムゾーンが異なる場合があります。意図しない日付のズレを防ぐため、プログラムの冒頭で `date_default_timezone_set(‘Asia/Tokyo’);` を指定しておくことを強く推奨します。