フォームから記事を追加する

入力フォームから記事を登録し、DB・一覧・個別記事までつなげます。

🎯 目的

フォームから記事を入力します。

入力した記事をMariaDBに保存します。

今回やること

  1. 記事追加フォームを作る
  2. 入力内容を受け取る
  3. DBに記事を保存する
  4. 一覧に表示する
  5. 個別記事を表示する
入力フォーム
↓
PHP
↓
MariaDB
↓
記事一覧
↓
個別記事

STEP 1|記事追加フォームを作る

タイトル、slug、本文を入力できるフォームを作ります。

<form method="post">

    <input type="text" name="title">

    <input type="text" name="slug">

    <textarea name="body"></textarea>

    <button type="submit">
        記事を追加
    </button>

</form>
📘 HTMLを読む
<form> = ユーザーが入力したデータを送信するためのフォームです。
method="post" = HTTPのPOSTメソッドを使ってデータを送信します。
<input type="text"> = 1行の文字入力欄です。
name="title" = 入力した値にtitleという名前を付けます。
name="slug" = 入力した値にslugという名前を付けます。
<textarea> = 複数行の文章を入力する欄です。
name="body" = 本文の値にbodyという名前を付けます。
type="submit" = フォームを送信するボタンです。

→ title・slug・bodyという3つの入力データをPOSTでPHPへ送ります。

STEP 2|入力内容を受け取る

POSTされた値をPHPで受け取ります。

$title = trim($_POST['title'] ?? '');

$slug = trim($_POST['slug'] ?? '');

$body = trim($_POST['body'] ?? '');
📘 PHPコードを読む
$_POST = POSTで送信された値を受け取るPHPのスーパーグローバル変数です。
$_POST['title'] = titleという名前で送信された値を取得します。
$_POST['slug'] = slugの値を取得します。
$_POST['body'] = bodyの値を取得します。
?? = null合体演算子です。左側の値が存在し、nullでなければその値を使い、そうでなければ右側の値を使います。
'' = 空文字列です。
trim() = 文字列の先頭と末尾にある空白などを取り除きます。

→ POSTされた値を受け取り、前後の不要な空白などを取り除いて変数へ入れています。

空欄がないか確認します。

if ($title === '' || $slug === '' || $body === '') {

    $message = 'すべて入力してください。';

}
📘 条件式を読む
if = 条件によって処理を分けます。
=== = 値と型の両方が同じかを比較します。
|| = 論理OR(または)です。複数の条件のうち、どれか1つでも成立すれば全体が真になります。
$message = ... = メッセージを変数$messageへ代入します。

→ title、slug、bodyのどれか1つでも空なら、「すべて入力してください。」というメッセージを用意します。
📘 科目Bにつなげる:論理OR
条件は次のように読めます。

titleが空
または
slugが空
または
bodyが空
↓
どれか1つでもYESなら、入力不足と判定する

→ ||を使うことで、複数の条件を1つの条件式として判定できます。

STEP 3|DBに保存する

INSERT文で記事を保存します。

$stmt = $pdo->prepare(
    'INSERT INTO articles (title, slug, body, status)
     VALUES (?, ?, ?, ?)'
);

$stmt->execute([
    $title,
    $slug,
    $body,
    'draft'
]);
📘 PHP・SQLを読む
prepare() = 値をあとから渡せる形でSQLを準備します。
INSERT INTO = テーブルへ新しいデータを追加するSQLです。
articles = データを追加するテーブルです。
(title, slug, body, status) = 値を入れるカラムを指定しています。
VALUES = 各カラムへ入れる値を指定します。
? = あとから値を渡すプレースホルダーです。

execute() = 準備したSQLへ実際の値を渡して実行します。
1番目の? → $title
2番目の? → $slug
3番目の? → $body
4番目の? → 'draft'

→ フォームから受け取った記事をarticlesテーブルへ新しい1行として追加しています。
📘 なぜprepare()を使う?
フォームの内容はユーザーが入力する外部データです。
入力値をSQL文字列へ直接つなげず、プレースホルダーとexecute()を使ってSQLの構造と値を分けます。
→ プリペアドステートメントを正しく使うことは、SQLインジェクション対策として重要です。
ポイント
今回は新しく追加した記事を draft で保存します。
draft は「下書き」という状態を表しています。

STEP 4|記事一覧で確認する

追加した記事が一覧に表示されます。

http://it-textbook.duckdns.org/article-list.php

今回のテストでは、

記事追加テスト

という記事を追加しました。

STEP 5|個別記事を表示する

一覧から記事をクリックします。

slugを使って記事を指定します。

article-detail.php?slug=test-article
📘 URLを読む
article-detail.php = 個別記事を表示するPHPファイルです。
? = URL本体とクエリ文字列を区切ります。
slug=test-article = slugという名前でtest-articleという値を渡しています。
→ 005で作った仕組みを使って、DBから該当する記事を探します。

DBから該当記事を取得して表示します。

今回の仕組み

フォーム
↓
POST
↓
PHP
↓
INSERT
↓
MariaDB
↓
記事一覧
↓
個別記事

ここまでつながれば、記事を追加できます。

📘 処理の流れを読む

今回は「フォームから入力されたデータを受け取り、DBへ新しい記事として保存する」処理です。

入力:フォームにtitle・slug・bodyを入力する
↓
送信:POSTで入力データをPHPへ送る
↓
処理①:$_POSTで値を受け取り、trim()で前後の空白などを取り除く
↓
条件分岐:title・slug・bodyに空欄がないか確認する
↓
処理②:INSERT文を実行してMariaDBへ記事を追加する
↓
出力:保存した記事を記事一覧や個別記事として表示する

→ これまでDBからデータを「読む」処理が中心でしたが、今回はフォームから受け取ったデータをDBへ「書く」処理が加わりました。

📝 今回の忘備録

フォームからPOSTでデータを送信する。
PHPでは$_POSTで受け取る。
||を使うと「または」という条件を作れる。
PDOのプリペアドステートメントでINSERTする。
今回は新規記事をdraftで保存する。

この先やること

タグ: HTML / PHP / POST / MariaDB / SQL / PDO / INSERT / 条件分岐 / CMS / VPS