フォームから記事を追加する
入力フォームから記事を登録し、DB・一覧・個別記事までつなげます。
🎯 目的
フォームから記事を入力します。
入力した記事をMariaDBに保存します。
今回やること
- 記事追加フォームを作る
- 入力内容を受け取る
- DBに記事を保存する
- 一覧に表示する
- 個別記事を表示する
入力フォーム
↓
PHP
↓
MariaDB
↓
記事一覧
↓
個別記事
↓
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を読む
→ title・slug・bodyという3つの入力データをPOSTでPHPへ送ります。
<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 = POSTで送信された値を受け取るPHPのスーパーグローバル変数です。$_POST['title'] = titleという名前で送信された値を取得します。$_POST['slug'] = slugの値を取得します。$_POST['body'] = bodyの値を取得します。?? = null合体演算子です。左側の値が存在し、nullでなければその値を使い、そうでなければ右側の値を使います。'' = 空文字列です。trim() = 文字列の先頭と末尾にある空白などを取り除きます。→ POSTされた値を受け取り、前後の不要な空白などを取り除いて変数へ入れています。
空欄がないか確認します。
if ($title === '' || $slug === '' || $body === '') {
$message = 'すべて入力してください。';
}
📘 条件式を読む
→ title、slug、bodyのどれか1つでも空なら、「すべて入力してください。」というメッセージを用意します。
if = 条件によって処理を分けます。=== = 値と型の両方が同じかを比較します。|| = 論理OR(または)です。複数の条件のうち、どれか1つでも成立すれば全体が真になります。$message = ... = メッセージを変数$messageへ代入します。→ title、slug、bodyのどれか1つでも空なら、「すべて入力してください。」というメッセージを用意します。
📘 科目Bにつなげる:論理OR
条件は次のように読めます。
titleが空
または
slugが空
または
bodyが空
↓
どれか1つでもYESなら、入力不足と判定する
→
条件は次のように読めます。
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を読む
1番目の
2番目の
3番目の
4番目の
→ フォームから受け取った記事をarticlesテーブルへ新しい1行として追加しています。
prepare() = 値をあとから渡せる形でSQLを準備します。INSERT INTO = テーブルへ新しいデータを追加するSQLです。articles = データを追加するテーブルです。(title, slug, body, status) = 値を入れるカラムを指定しています。VALUES = 各カラムへ入れる値を指定します。? = あとから値を渡すプレースホルダーです。execute() = 準備したSQLへ実際の値を渡して実行します。1番目の
? → $title2番目の
? → $slug3番目の
? → $body4番目の
? → 'draft'→ フォームから受け取った記事をarticlesテーブルへ新しい1行として追加しています。
📘 なぜprepare()を使う?
フォームの内容はユーザーが入力する外部データです。
入力値をSQL文字列へ直接つなげず、プレースホルダーと
→ プリペアドステートメントを正しく使うことは、SQLインジェクション対策として重要です。
フォームの内容はユーザーが入力する外部データです。
入力値を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を読む
→ 005で作った仕組みを使って、DBから該当する記事を探します。
article-detail.php = 個別記事を表示するPHPファイルです。? = URL本体とクエリ文字列を区切ります。slug=test-article = slugという名前でtest-articleという値を渡しています。→ 005で作った仕組みを使って、DBから該当する記事を探します。
DBから該当記事を取得して表示します。
今回の仕組み
フォーム
↓
POST
↓
PHP
↓
INSERT
↓
MariaDB
↓
記事一覧
↓
個別記事
↓
POST
↓
PHP
↓
INSERT
↓
MariaDB
↓
記事一覧
↓
個別記事
ここまでつながれば、記事を追加できます。
📘 処理の流れを読む
今回は「フォームから入力されたデータを受け取り、DBへ新しい記事として保存する」処理です。
入力:フォームにtitle・slug・bodyを入力する
↓
送信:POSTで入力データをPHPへ送る
↓
処理①:$_POSTで値を受け取り、trim()で前後の空白などを取り除く
↓
条件分岐:title・slug・bodyに空欄がないか確認する
↓
処理②:INSERT文を実行してMariaDBへ記事を追加する
↓
出力:保存した記事を記事一覧や個別記事として表示する
→ これまでDBからデータを「読む」処理が中心でしたが、今回はフォームから受け取ったデータをDBへ「書く」処理が加わりました。
入力:フォームにtitle・slug・bodyを入力する
↓
送信:POSTで入力データをPHPへ送る
↓
処理①:$_POSTで値を受け取り、trim()で前後の空白などを取り除く
↓
条件分岐:title・slug・bodyに空欄がないか確認する
↓
処理②:INSERT文を実行してMariaDBへ記事を追加する
↓
出力:保存した記事を記事一覧や個別記事として表示する
→ これまでDBからデータを「読む」処理が中心でしたが、今回はフォームから受け取ったデータをDBへ「書く」処理が加わりました。
📝 今回の忘備録
フォームからPOSTでデータを送信する。
PHPでは
PDOのプリペアドステートメントでINSERTする。
今回は新規記事をdraftで保存する。
PHPでは
$_POSTで受け取る。||を使うと「または」という条件を作れる。PDOのプリペアドステートメントでINSERTする。
今回は新規記事をdraftで保存する。
この先やること
- 記事を編集する
- 記事を削除する
- 公開・下書きを切り替える