自作CMSをCOLUMNSへ発展させる
これまで作ってきたログイン認証・権限管理・記事CMSを、実際の公開コンテンツ「COLUMNS」へつなげます。
🎯 目的
これまで、自作CMSでログイン認証、ユーザーのrole、 記事のauthor_idやstatusを使った権限管理を作ってきました。
今回は、そのCMSで公開した記事を、 IT教科書の新しいコンテンツ「COLUMNS」として 一般公開できるようにします。
練習用として作ってきたCMSを、 実際のWebサイトの機能へつなげる回です。
今回やること
- 既存のCMSとCOLUMNSをつなげる
- publishedの記事だけを一般公開する
- 記事一覧から個別記事へ移動できるようにする
- COLUMNSの記事にも前後ナビゲーションを付ける
↓
自作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'
WHERE = 取得するデータに条件を付けます。a.status = articlesテーブルの記事状態です。= = 左右の値が等しいものを対象にします。'published' = 公開済みを表すstatusです。→ 「statusがpublishedの記事だけを取得する」という条件です。
CMSにはdraftやin_reviewなどの記事も存在します。
一方、一般の人が見るCOLUMNSでは publishedだけを表示します。
→ 「DBに存在する記事」と 「一般公開してよい記事」は同じではありません。
STEP 3|一覧から個別記事へつなげる
COLUMNSの一覧ページは
columns.phpで作りました。
記事タイトルをクリックすると、 slugを使って個別記事へ移動します。
/column-detail.php?slug=記事のslug
column-detail.php = COLUMNSの個別記事を表示するPHPです。? = URL本体とパラメータを区切ります。slug= = 表示する記事のslugを渡します。→ 一覧ページから「どの記事を表示するか」という情報を 個別ページへ渡しています。
個別記事側でも、slugだけではなく statusがpublishedであることを確認します。
WHERE a.slug = ?
AND a.status = ?
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サイトの流れとしてつながりました。
📘 処理の流れを読む
↓
保存: 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は「サーバー側の処理で問題が起きた」というように、 エラーの種類から調べる場所を絞ることができる。
この先やること
- Markdownで保存した記事本文をHTMLとして表示する
- 日本語が崩れた原因を調べ、UTF-8として正しく処理する
- COLUMNSの記事一覧や表示方法をさらに整える