サイトを雛形として整理する
ここまで作ってきたIT教科書サイトを、次の制作にも使える雛形として整理します。ファイルの役割を確認し、共通部分と個別部分を分けながら、サイト全体の構造を理解します。
🎯 目的
ここまで、ARTICLESやCOLUMNS、検索、ページネーション、 共通部品などを少しずつ作ってきました。
今回は、それぞれの処理を単独で見るのではなく、 サイト全体を「次の制作にも使える雛形」として整理します。
重要なのは、ファイルをただ並べることではありません。 「どのファイルが何を担当しているのか」を理解することです。
今回やること
- サイトを構成するファイルの役割を整理する
- 共通部分と個別処理の関係を確認する
- 次の制作でも使える構造として考える
↓
PHPが処理
↓
必要なデータを取得
↓
共通部品を利用
↓
HTMLとして表示
今回の仕組み
このサイトでは、すべての処理を1つのPHPファイルに詰め込むのではなく、 役割ごとにファイルを分けています。
例えば、記事一覧を表示する処理と、 ページネーションの処理は別の役割です。
そのため、ページネーションは
pagination.phpという共通部品にまとめました。
このように「何を担当するファイルなのか」を意識して分けることで、 後から修正するときにも全体を追いやすくなります。
STEP 1|ファイルの役割を整理する
まず、サイトにあるPHPファイルを役割ごとに考えてみます。
index.php
articles.php
columns.php
article-detail.php
column-detail.php
article-add.php
article-edit.php
article-delete.php
article-status.php
pagination.php
db.php
csrf.php
login.php
logout.php
article-common.css
site-common.css
index.php = TOPページを担当するファイルarticles.php = ARTICLES一覧を担当するファイルcolumns.php = COLUMNS一覧を担当するファイルarticle-detail.php = 記事詳細を担当するファイルarticle-add.php = 記事追加を担当するファイルarticle-edit.php = 記事編集を担当するファイルarticle-delete.php = 記事削除を担当するファイルarticle-status.php = 記事ステータス変更を担当するファイルpagination.php = ページネーションの共通処理を担当するファイルdb.php = データベース接続を担当するファイルcsrf.php = CSRF対策に関する処理を担当するファイル→ ファイル名を見るだけでも、 それぞれのファイルが何を担当しているのか分かるように整理しています。
article-common.css = 記事ページで共通して使うCSSsite-common.css = サイト全体で共通して使うCSS→ CSSも役割を分けることで、 同じスタイルを何度も書かずに済むようにしています。
STEP 2|共通部分と個別部分を分ける
次に、ARTICLESとCOLUMNSを比較します。
<?php
$paginationBaseUrl =
'/articles.php?project=' . urlencode($project);
include __DIR__ . '/pagination.php';
?>
COLUMNSではURLだけが変わります。
<?php
$paginationBaseUrl =
'/columns.php?type=' . urlencode($type);
include __DIR__ . '/pagination.php';
?>
$paginationBaseUrl = ページネーションの基本URLurlencode() = URLで安全に扱える形へ変換する関数include = 別のPHPファイルを読み込む構文__DIR__ = 現在のPHPファイルがあるディレクトリ→ ARTICLESとCOLUMNSでは、 URLという「違う部分」だけをそれぞれ用意しています。 ページネーションそのものは共通部品を使っています。
ARTICLES
↓
URLを用意
↓
pagination.php
↓
共通処理
COLUMNSも同じ流れです。
→ 「違う部分」と「同じ部分」を分けることで、 同じコードを何度も書かなくても済む構造になっています。
STEP 3|雛形として使える状態を考える
最後に、このサイトを「今回だけ動けばよいもの」ではなく、 次の制作にも応用できる雛形として考えます。
TOP
│
├─ ARTICLES
│ ├─ 一覧
│ └─ 詳細
│
├─ COLUMNS
│ ├─ 一覧
│ └─ 詳細
│
├─ 共通部品
│ └─ pagination.php
│
├─ 認証・セキュリティ
│ ├─ login.php
│ ├─ logout.php
│ └─ csrf.php
│
└─ CSS
├─ site-common.css
└─ article-common.css
include = 共通処理を別ファイルから読み込むrequire = 必要なファイルを読み込む__DIR__ = 現在のファイルのディレクトリを表す→ PHPでは、処理を役割ごとのファイルに分け、 必要な場所から呼び出すことでサイト全体を組み立てています。
<main> = ページの主要な内容を表す要素<article> = 独立した記事コンテンツを表す要素<section> = 内容ごとのまとまりを表す要素→ HTMLでは、ページの内容を意味ごとに整理しています。
max-width = 要素の最大幅を指定するmargin = 要素の外側の余白を指定するpadding = 要素の内側の余白を指定する@media = 画面サイズなどの条件に応じてCSSを切り替える→ CSSでは、PCとスマートフォンの両方で読みやすくなるよう、 ページの見た目を整理しています。
📘 前の記事とのつながり
ARTICLESにページネーションを作りました。
026|ページネーションを共通部品にする
ページネーションを
pagination.phpにまとめ、
ARTICLESとCOLUMNSの両方から使えるようにしました。今回
ページネーションだけではなく、 サイト全体を「役割ごとのファイル」という視点から整理しました。
→ 「機能を作る」→「共通化する」→「全体を整理する」 という流れになっています。
📘 処理の流れを読む
↓
処理: PHPが必要な処理を行い、 必要に応じて共通部品やデータベースを利用する
↓
出力: HTMLとしてブラウザにページを表示する
→ Webサイト全体も、 「入力 → 処理 → 出力」という流れで考えることができます。
📝 今回の忘備録
ファイルが増えてきたら、 「どのファイルが何を担当しているのか」を確認します。
同じ処理が複数の場所に出てきたら、 共通部品にできないか考えます。
ただし、何でも共通化すればよいわけではありません。 共通している部分と、ページごとに違う部分を見分けることが重要です。
今回作ったサイトは、単に完成したWebサイトというだけではなく、 PHP、HTML、CSS、データベース、認証、共通部品などを 学習するための雛形にもなっています。
この先やること
- 実際にサイト全体を使って動作確認する
- 記事を増やしながら構造を見直す
- 必要になった共通処理を少しずつ整理する
- 次の制作では、この雛形を出発点として利用する