記事を編集する
既存の記事を編集し、MariaDBの内容を更新します。
🎯 目的
既存の記事を取得します。
内容を変更します。
変更した内容をDBへ保存します。
今回やること
- 記事をIDで指定する
- DBから記事を取得する
- 編集フォームに表示する
- 変更内容を受け取る
- UPDATEでDBを更新する
- ブラウザで確認する
記事を指定
↓
MariaDBから取得
↓
編集フォーム
↓
UPDATE
↓
MariaDB
↓
MariaDBから取得
↓
編集フォーム
↓
UPDATE
↓
MariaDB
STEP 1|記事を指定する
URLから記事IDを受け取ります。
$id = (int)($_GET['id'] ?? 0);
if ($id === 0) {
exit('記事が指定されていません。');
}
📘 PHPコードを読む
→ URLから受け取ったidを整数に変換し、0なら記事が指定されていないと判断して処理を終了します。
$_GET['id'] = URLのクエリ文字列からidの値を受け取ります。?? 0 = idが存在しない、またはnullなら0を使います。(int) = 値を整数型(integer)へ変換する型キャストです。$id = 記事を識別するIDを保存する変数です。if = 条件によって処理を分けます。=== = 値と型の両方が同じか比較します。exit() = PHPの処理をそこで終了します。→ URLから受け取ったidを整数に変換し、0なら記事が指定されていないと判断して処理を終了します。
📘 URLではどう見える?
例えば、
なら、
→ 「どの記事を編集するか」をIDで指定しています。
例えば、
article-edit.php?id=2なら、
$_GET['id']で受け取る値は2です。→ 「どの記事を編集するか」をIDで指定しています。
STEP 2|記事を取得する
IDを使ってDBから記事を取得します。
$stmt = $pdo->prepare(
'SELECT id, title, slug, body, status
FROM articles
WHERE id = ?'
);
$stmt->execute([$id]);
$article = $stmt->fetch(PDO::FETCH_ASSOC);
📘 PHP・SQLを読む
→ 編集対象の記事をIDで探し、現在の内容を取得しています。
prepare() = 値をあとから渡せる形でSQLを準備します。SELECT = DBからデータを取得します。id, title, slug, body, status = 取得するカラムです。FROM articles = articlesテーブルを検索します。WHERE id = ? = 指定したIDと一致する行だけを対象にします。? = あとから値を入れるプレースホルダーです。execute([$id]) = プレースホルダーへ$idを渡してSQLを実行します。fetch() = 検索結果から1行を取得します。PDO::FETCH_ASSOC = カラム名をキーにした連想配列として取得します。→ 編集対象の記事をIDで探し、現在の内容を取得しています。
STEP 3|編集フォームに表示する
取得した記事をフォームに表示します。
<input
type="text"
name="title"
value="<?= htmlspecialchars($article['title']) ?>"
>
<textarea name="body"><?=
htmlspecialchars($article['body'])
?></textarea>
📘 HTML・PHPを読む
→ DBに保存されている現在の内容をフォームへ入れ、そこから編集できる状態にしています。
value="..." = input欄に最初から表示する値を指定します。$article['title'] = DBから取得した現在の記事タイトルです。<textarea>...</textarea> = 開始タグと終了タグの間に本文を入れることで、現在の本文を入力欄へ表示します。$article['body'] = DBから取得した現在の記事本文です。htmlspecialchars() = HTMLで特別な意味を持つ文字をエスケープし、フォーム内で文字として表示します。→ DBに保存されている現在の内容をフォームへ入れ、そこから編集できる状態にしています。
STEP 4|変更内容を受け取る
フォームから送信された値を受け取ります。
$title = trim($_POST['title'] ?? '');
$slug = trim($_POST['slug'] ?? '');
$body = trim($_POST['body'] ?? '');
$status = trim($_POST['status'] ?? 'draft');
📘 PHPコードを読む
→ 編集後のtitle・slug・body・statusをPHPの変数へ入れています。
$_POST = POSTで送信されたフォームの値を受け取ります。trim() = 文字列の先頭と末尾にある空白などを取り除きます。?? = 左側の値が存在し、nullでなければその値を使い、そうでなければ右側を使います。'draft' = statusが送信されなかった場合に使う初期値です。→ 編集後のtitle・slug・body・statusをPHPの変数へ入れています。
STEP 5|UPDATEする
変更した内容をDBへ保存します。
$stmt = $pdo->prepare(
'UPDATE articles
SET title = ?, slug = ?, body = ?, status = ?
WHERE id = ?'
);
$stmt->execute([
$title,
$slug,
$body,
$status,
$id
]);
📘 SQLを読む
1番目 →
2番目 →
3番目 →
4番目 →
5番目 →
→ 指定したIDの記事について、編集された内容だけをDBへ保存します。
UPDATE articles = articlesテーブルの既存データを更新します。SET = どのカラムをどの値へ変更するか指定します。title = ? = titleを新しい値へ変更します。slug = ? = slugを新しい値へ変更します。body = ? = bodyを新しい値へ変更します。status = ? = statusを新しい値へ変更します。WHERE id = ? = 指定したIDの記事だけを更新します。execute()では、?の順番に値が入ります。1番目 →
$title2番目 →
$slug3番目 →
$body4番目 →
$status5番目 →
$id→ 指定したIDの記事について、編集された内容だけをDBへ保存します。
📘 WHEREが重要
UPDATE文では、更新対象を正しく限定することが非常に重要です。
→ 今回はIDが一致する記事だけを更新します。
WHERE id = ?は、「どの記事を更新するか」を指定しています。UPDATE文では、更新対象を正しく限定することが非常に重要です。
→ 今回はIDが一致する記事だけを更新します。
ポイント
006では
007では
006では
INSERTを使って新しい行を追加しました。007では
UPDATEを使って、すでに存在する行の内容を変更します。
STEP 6|ブラウザで確認する
テスト記事を編集します。
http://it-textbook.duckdns.org/article-edit.php?id=2
本文を変更します。
これは記事編集のテストです。
更新後、記事一覧から個別記事を確認します。
成功
変更した内容が表示されれば成功です。
変更した内容が表示されれば成功です。
今回の仕組み
IDで記事を指定
↓
SELECTで現在の内容を取得
↓
編集フォームに表示
↓
POSTで変更内容を送信
↓
UPDATE
↓
DBの内容が変更される
↓
SELECTで現在の内容を取得
↓
編集フォームに表示
↓
POSTで変更内容を送信
↓
UPDATE
↓
DBの内容が変更される
📘 処理の流れを読む
今回は「既存の記事を読み出し、編集された内容で同じ記事を更新する」処理です。
入力①:URLから編集する記事のIDを受け取る
↓
条件分岐:IDが0なら処理を終了する
↓
処理①:SELECTとWHEREを使って該当する記事を取得する
↓
出力①:現在のtitleやbodyを編集フォームに表示する
↓
入力②:ユーザーが内容を変更してPOSTする
↓
処理②:UPDATEとWHEREを使って指定した記事を更新する
↓
出力②:変更後の記事がDBに保存され、更新された内容を表示できる
→ 「取得 → 編集 → 更新」という一連の処理になっています。
入力①:URLから編集する記事のIDを受け取る
↓
条件分岐:IDが0なら処理を終了する
↓
処理①:SELECTとWHEREを使って該当する記事を取得する
↓
出力①:現在のtitleやbodyを編集フォームに表示する
↓
入力②:ユーザーが内容を変更してPOSTする
↓
処理②:UPDATEとWHEREを使って指定した記事を更新する
↓
出力②:変更後の記事がDBに保存され、更新された内容を表示できる
→ 「取得 → 編集 → 更新」という一連の処理になっています。
📘 CRUDで見る
CMSの基本操作は、よくCRUDという4つの処理で整理されます。
C = Create:作成する →
R = Read:読み取る →
U = Update:更新する →
D = Delete:削除する →
→ 006ではCreate、007ではReadしてからUpdateする処理を使っています。
C = Create:作成する →
INSERTR = Read:読み取る →
SELECTU = Update:更新する →
UPDATED = Delete:削除する →
DELETE→ 006ではCreate、007ではReadしてからUpdateする処理を使っています。
📝 今回の忘備録
編集する記事をIDで指定する。
SELECTで現在の内容を取得する。
DBの内容をフォームへ表示する。
POSTで変更後の値を受け取る。
UPDATEで変更内容を保存する。
WHEREで更新する記事を限定する。
SELECTで現在の内容を取得する。
DBの内容をフォームへ表示する。
POSTで変更後の値を受け取る。
UPDATEで変更内容を保存する。
WHEREで更新する記事を限定する。
この先やること
- 記事を削除する
- 公開・下書きを切り替える
- 管理画面を整理する