自作CMSをCOLUMNSへ発展させる

これまで作ってきたログイン認証・権限管理・記事CMSを、実際の公開コンテンツ「COLUMNS」へつなげます。

🎯 目的

これまで、自作CMSでログイン認証、ユーザーのrole、 記事のauthor_idやstatusを使った権限管理を作ってきました。

今回は、そのCMSで公開した記事を、 IT教科書の新しいコンテンツ「COLUMNS」として 一般公開できるようにします。

練習用として作ってきたCMSを、 実際のWebサイトの機能へつなげる回です。

今回やること

  1. 既存のCMSとCOLUMNSをつなげる
  2. publishedの記事だけを一般公開する
  3. 記事一覧から個別記事へ移動できるようにする
  4. COLUMNSの記事にも前後ナビゲーションを付ける
writer / editor / admin
↓
自作CMS
↓
MariaDBのarticles
↓
status = published
↓
COLUMNS
↓
一般公開

STEP 1|これまで作ったCMSを使う

これまでの記事で、 ログインしたユーザーが記事を作成・管理できるCMSを作ってきました。

記事はMariaDBのarticlesテーブルへ保存されています。

articles

id
author_id
title
slug
body
status
created_at
updated_at
📘 データを読む

id = 記事を識別するIDです。
author_id = 記事を書いたユーザーのIDです。
title = 記事タイトルです。
slug = URLなどで記事を識別する文字列です。
body = 記事本文です。
status = 記事の現在の状態です。

→ CMSで作った記事は、公開画面とは別の場所にあるのではなく、 同じarticlesテーブルに保存されています。

つまり、新しい投稿システムをもう一度作る必要はありません。

すでに作ったCMSの記事データを、 COLUMNS側から読み出せばよいことになります。

STEP 2|publishedの記事だけをCOLUMNSへ出す

articlesには下書きや公開依頼中の記事も保存されています。

そのため、COLUMNSでは publishedの記事だけを取得します。

WHERE a.status = 'published'
📘 SQLを読む

WHERE = 取得するデータに条件を付けます。
a.status = articlesテーブルの記事状態です。
= = 左右の値が等しいものを対象にします。
'published' = 公開済みを表すstatusです。

→ 「statusがpublishedの記事だけを取得する」という条件です。
📘 CMSと公開画面の役割

CMSにはdraftやin_reviewなどの記事も存在します。

一方、一般の人が見るCOLUMNSでは publishedだけを表示します。

→ 「DBに存在する記事」と 「一般公開してよい記事」は同じではありません。

STEP 3|一覧から個別記事へつなげる

COLUMNSの一覧ページは columns.phpで作りました。

記事タイトルをクリックすると、 slugを使って個別記事へ移動します。

/column-detail.php?slug=記事のslug
📘 URLを読む

column-detail.php = COLUMNSの個別記事を表示するPHPです。
? = URL本体とパラメータを区切ります。
slug= = 表示する記事のslugを渡します。

→ 一覧ページから「どの記事を表示するか」という情報を 個別ページへ渡しています。

個別記事側でも、slugだけではなく statusがpublishedであることを確認します。

WHERE a.slug = ?
  AND a.status = ?
📘 SQLを読む

a.slug = ?
→ 指定されたslugの記事を探します。

AND
→ さらに別の条件も満たす必要があります。

a.status = ?
→ statusも指定された値と一致する必要があります。

→ 「指定されたslug」かつ「published」の記事だけを表示します。

さらに、 column-nav.phpを使って COLUMNSの記事にも前の記事・次の記事へのナビゲーションを付けました。

📘 前の記事とのつながり

これまで
ログイン認証を作り、 ユーザーを識別できるようにしました。

admin / writerなどのroleや、 author_id、statusを使って 記事を操作できる範囲も制御しました。

さらにCMSで記事を作成し、 MariaDBへ保存できるようにしました。

今回
そのCMSでpublishedになった記事を、 公開ページのCOLUMNSから読み出しました。

→ これまで個別に作ってきた 「認証」「認可」「DB」「CMS」が、 1つの公開Webサイトの流れとしてつながりました。

📘 処理の流れを読む

入力: CMSから記事を作成・編集・公開する
↓
保存: articlesテーブルへ記事データを保存する
↓
条件: statusがpublishedか確認する
↓
処理: COLUMNS側で公開記事を取得する
↓
出力: 一覧ページ・個別ページとしてブラウザへ表示する

→ 「CMSで入力 → DBへ保存 → 公開条件を確認 → COLUMNSへ出力」 という流れになりました。

📝 今回の忘備録

新しい公開ページを作るからといって、 投稿機能まで新しく作る必要はなかった。 既存CMSのarticlesテーブルをそのまま利用できる。

COLUMNSの一覧だけでpublishedを絞り込むのではなく、 個別記事側でもpublishedか確認する。

最初は一覧から記事をクリックすると404になった。 原因はリンク先の column-detail.phpがまだ存在していなかったため。

個別ページを作ったあとには500エラーも発生した。 nginxのerror.logを確認すると、 PDOの SQLSTATE[HY093]: Invalid parameter number が原因だと分かった。

SQLでは2個のプレースホルダーを使っているのに、 古いexecuteが残っていたため、 渡す値の数が一致していなかった。

404は「目的のページやファイルが見つからない」、 500は「サーバー側の処理で問題が起きた」というように、 エラーの種類から調べる場所を絞ることができる。

この先やること

タグ: PHP / MariaDB / SQL / CMS / COLUMNS / Authentication / Authorization / status / published / PDO