サイトを雛形として整理する

ここまで作ってきたIT教科書サイトを、次の制作にも使える雛形として整理します。ファイルの役割を確認し、共通部分と個別部分を分けながら、サイト全体の構造を理解します。

🎯 目的

ここまで、ARTICLESやCOLUMNS、検索、ページネーション、 共通部品などを少しずつ作ってきました。

今回は、それぞれの処理を単独で見るのではなく、 サイト全体を「次の制作にも使える雛形」として整理します。

重要なのは、ファイルをただ並べることではありません。 「どのファイルが何を担当しているのか」を理解することです。

今回やること

  1. サイトを構成するファイルの役割を整理する
  2. 共通部分と個別処理の関係を確認する
  3. 次の制作でも使える構造として考える
ブラウザからアクセス
↓
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
📘 PHPを読む

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対策に関する処理を担当するファイル

→ ファイル名を見るだけでも、 それぞれのファイルが何を担当しているのか分かるように整理しています。
📘 CSSを読む

article-common.css = 記事ページで共通して使うCSS
site-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';

?>
📘 PHPを読む

$paginationBaseUrl = ページネーションの基本URL
urlencode() = 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
📘 PHPを読む

include = 共通処理を別ファイルから読み込む
require = 必要なファイルを読み込む
__DIR__ = 現在のファイルのディレクトリを表す

→ PHPでは、処理を役割ごとのファイルに分け、 必要な場所から呼び出すことでサイト全体を組み立てています。
📘 HTMLを読む

<main> = ページの主要な内容を表す要素
<article> = 独立した記事コンテンツを表す要素
<section> = 内容ごとのまとまりを表す要素

→ HTMLでは、ページの内容を意味ごとに整理しています。
📘 CSSを読む

max-width = 要素の最大幅を指定する
margin = 要素の外側の余白を指定する
padding = 要素の内側の余白を指定する
@media = 画面サイズなどの条件に応じてCSSを切り替える

→ CSSでは、PCとスマートフォンの両方で読みやすくなるよう、 ページの見た目を整理しています。

📘 前の記事とのつながり

025|ページネーションを作る
ARTICLESにページネーションを作りました。

026|ページネーションを共通部品にする
ページネーションをpagination.phpにまとめ、 ARTICLESとCOLUMNSの両方から使えるようにしました。

今回
ページネーションだけではなく、 サイト全体を「役割ごとのファイル」という視点から整理しました。

→ 「機能を作る」→「共通化する」→「全体を整理する」 という流れになっています。

📘 処理の流れを読む

入力: ブラウザからのアクセスやユーザーの操作
↓
処理: PHPが必要な処理を行い、 必要に応じて共通部品やデータベースを利用する
↓
出力: HTMLとしてブラウザにページを表示する

→ Webサイト全体も、 「入力 → 処理 → 出力」という流れで考えることができます。

📝 今回の忘備録

ファイルが増えてきたら、 「どのファイルが何を担当しているのか」を確認します。

同じ処理が複数の場所に出てきたら、 共通部品にできないか考えます。

ただし、何でも共通化すればよいわけではありません。 共通している部分と、ページごとに違う部分を見分けることが重要です。

今回作ったサイトは、単に完成したWebサイトというだけではなく、 PHP、HTML、CSS、データベース、認証、共通部品などを 学習するための雛形にもなっています。

この先やること

タグ: PHP / HTML / CSS / 共通部品 / ファイル構成 / Web制作 / 雛形