既存のPHP記事をCMSのDBへ移行する
PHPファイルで作っていた忘備録を、MariaDBのarticlesテーブルへ移行し、自作CMSから管理・表示できるようにします。
🎯 目的
これまでPHPファイルとして作ってきた忘備録を、CMSの記事としてMariaDBへ移行します。
移行後は、管理画面から記事を管理し、個別記事ページから表示できるようにします。
今回やること
- articlesテーブルの構造を確認する
- 既存のPHP記事を確認する
- インポート用PHPを作る
- PHPファイルからtitleと本文を取得する
- MariaDBへ記事を登録する
- 既存記事の場合はUPDATEする
- article-detail.phpの共通CSSで表示する
- 管理画面から記事を確認する
↓
インポート処理
↓
MariaDB
↓
admin.php
↓
article-detail.php
↓
ブラウザ
STEP 1|articlesテーブルを確認する
まず、記事を保存するarticlesテーブルの構造を確認します。
sudo mysql -u root -p it_textbook_test -e "DESCRIBE articles;"
sudo = 権限を切り替えてコマンドを実行します。多くの場合、管理者権限が必要な操作で使います。mysql = MySQL互換のクライアントを起動するコマンドです。MariaDBにも接続できます。-u root = 接続するDBユーザーをrootに指定します。-p = パスワード入力を求めます。it_textbook_test = 接続するデータベース名です。-e = 後ろに書いたSQLを実行します。DESCRIBE articles; = articlesテーブルのカラム構造を確認するSQLです。→ MariaDBへ接続し、articlesテーブルがどんな構造になっているか確認しています。
今回確認した構造は次のとおりです。
id:記事IDtitle:記事タイトルslug:記事URL用の識別子body:記事本文status:draft / publishedcreated_at:作成日時updated_at:更新日時
slugには
UNIQUE制約があります。UNIQUEは「同じ値を重複して保存できない」という制約です。
→ 同じslugの記事をもう一度INSERTしようとすると、重複を許さないDBの制約に引っかかります。
STEP 2|既存のPHP記事を確認する
これまで作ってきた忘備録は、PHPファイルとして保存されています。
ls -1 /var/www/it-textbook/article-*.php
ls = ファイルやディレクトリの一覧を表示します。-1 = 1行に1件ずつ表示します。ここは数字の「1」です。/var/www/it-textbook/ = 記事ファイルがあるディレクトリです。article-*.php = article-で始まり.phpで終わるファイルを対象にします。* = 0文字以上の任意の文字列に一致するシェルのワイルドカードです。→ article-001.php、article-002.phpなどをまとめて確認できます。
今回は001〜011を確認しました。
ただし、article-005.phpは存在しなかったため、
内容を推測して作ることはせず、005はスキップしました。
存在しない記事を推測で補完せず、実際に確認できたものだけをCMSへ移行します。
STEP 3|インポーターを作る
1記事だけを登録する処理を試したあと、 番号を指定して任意の記事を登録できる汎用インポーターを作りました。
sudo nano /var/www/it-textbook/import-article.php
nano = ターミナル上で使えるテキストエディタです。import-article.php = 記事をDBへ移行するために作ったPHPファイルです。→ インポート処理そのものをPHPプログラムとして作っています。
例えば002を登録するときは次のように実行します。
php /var/www/it-textbook/import-article.php 002
php = PHPファイルをコマンドラインから実行します。import-article.php = 実行するPHPプログラムです。002 = プログラムへ渡す引数です。→ 「002を処理してほしい」という入力を、インポーターへ渡しています。
STEP 4|PHPファイルから記事情報を取得する
PHPファイルから$titleと$leadを取得します。
preg_match(
"/\\\$title\s*=\s*'([^']*)'/",
$html,
$title_match
);
preg_match() = 正規表現を使って、文字列の中から条件に一致する部分を探すPHP関数です。$html = 検索対象となる元のPHPファイルの内容です。$title_match = 見つかった結果を受け取る変数です。→ ファイル全体の文字列から、titleを書いている部分を探しています。
正規表現は「どんな文字列を探すか」をパターンで指定する書き方です。
\s* = 空白文字が0個以上続く部分に一致します。( ... ) = 一致した部分の一部をグループとして取り出します。[^'] = シングルクォート以外の文字を表します。* = 直前のパターンが0回以上続くことを表します。→
$title = '...';という形から、タイトル部分を取り出すためのパターンです。
また、<article>から</article>までを
本文として取り出します。
preg_match(
'/<article>(.*?)<\/article>/is',
$html,
$body_match
);
. = 基本的に任意の1文字を表します。* = 直前のパターンを0回以上繰り返します。? = ここでは*の繰り返しを最短一致にします。i = 大文字・小文字を区別しない指定です。s = .が改行にも一致するようにする指定です。→ articleタグの開始から終了までを、本文として取り出します。
STEP 5|<h1>をDB本文から除外する
CMSの個別記事ページでは、DBのtitleを使って
<h1>を表示します。
そのため、元のPHPファイルにある<h1>まで
bodyに保存すると、タイトルが二重になります。
$body = preg_replace(
'/<h1>.*?<\/h1>/is',
'',
$body,
1
);
preg_replace() = 正規表現に一致した文字列を別の文字列へ置き換えるPHP関数です。1番目 = 探すパターン
2番目の
'' = 置き換える文字列。今回は空文字なので削除になります。3番目の
$body = 処理する本文です。4番目の
1 = 最大1回だけ置換します。→ 本文の最初にあるh1を1つ削除しています。
最初のインポートではタイトルが二重表示されました。
DB本文からh1を削除し、表示側でtitleを出す構造に修正しました。
STEP 6|新規記事はINSERTする
DBに存在しない記事はINSERTします。
INSERT INTO articles
(title, slug, body, status)
VALUES
(?, ?, ?, ?)
INSERT INTO articles = articlesテーブルへ新しい行を追加します。(title, slug, body, status) = 値を保存するカラムです。VALUES = 登録する値を指定します。? = あとから値を渡すプレースホルダーです。→ DBにまだ存在しない記事を、新しい記事として登録します。
移行した記事は、まずdraftとして登録しました。
いきなり公開せず、draftで登録して表示確認してから公開する方針にしました。
STEP 7|既存記事はUPDATEする
slugがすでに存在する場合はINSERTせず、既存記事をUPDATEします。
UPDATE articles
SET title = ?, body = ?
WHERE slug = ?
UPDATE articles = articlesテーブルの既存データを更新します。SET = 変更するカラムと値を指定します。title = ? = titleを新しい値へ変更します。body = ? = bodyを新しい値へ変更します。WHERE slug = ? = 指定したslugの記事だけを更新します。→ 同じslugの記事を新しく増やすのではなく、すでにある記事の内容を更新します。
このときstatusは変更しません。
001はすでにpublishedだったため、再インポートしてもpublishedのままです。
slugがDBに存在しない
→
INSERTslugがDBに存在する
→
UPDATE→ 同じインポーターを再実行しても、同じslugの記事を重複して増やさず、既存記事を更新できる仕組みにしています。
処理を日本語で考えると、
slugはすでに存在するか?
↓
YES → UPDATE
NO → INSERT
→ 条件によって実行する処理を切り替える、典型的な分岐です。
STEP 8|記事本文とCSSを分離する
DBには記事本文のHTMLを保存し、記事全体の見た目は
article-detail.phpの共通CSSで管理します。
↓
HTML本文
↓
article-detail.php
↓
共通CSS
MariaDB = title・slug・body・statusなどの記事データを保存する
article-detail.php = DBから記事を取得してページを組み立てる
CSS = ページの見た目を整える
→ 記事ごとに同じCSSを書くのではなく、共通の表示側でデザインを適用できます。
これによって、PHPファイルとして作った記事と同じように、 コードブロック・ポイント・フローなどのデザインを CMSの記事でも再現できました。
STEP 9|記事をCMSへ移行する
今回、次の記事をDBへ移行しました。
- 001|VPSにPHPのテストページを表示する
- 002|DuckDNSで無料のドメインを作る
- 003|MariaDBを作ってPHPから記事を表示する
- 004|MariaDBから記事一覧を表示する
- 005|記事一覧から個別記事を表示する
- 006|フォームから記事を追加する
- 007|記事を編集する
- 008|記事を削除する
- 009|公開・下書きを切り替える
- 010|公開記事だけを表示する
- 011|管理画面を整理する
005は存在しなかったためスキップしました。
今回のCMS構造
↓
title・本文を抽出
↓
slugが存在するか確認
↓
INSERT または UPDATE
↓
MariaDB / articles
↓
admin.php
↓
article-detail.php + 共通CSS
↓
ブラウザ
📘 処理の流れを読む
入力:記事番号をインポーターへ渡す
↓
処理①:対象のPHPファイルを読む
↓
処理②:正規表現でtitleと本文を取り出す
↓
処理③:本文から重複するh1を除外する
↓
条件判定:同じslugの記事がDBに存在するか確認する
↓
分岐:存在しない → INSERT / 存在する → UPDATE
↓
保存:MariaDBのarticlesテーブルへ保存する
↓
出力:article-detail.phpで記事として表示する
→ 「入力 → 抽出 → 加工 → 判定 → 保存 → 表示」という流れになっています。
📘 今回は「データ移行」
それを読み取り、CMSで扱える形にしてMariaDBへ保存しました。
移行前
PHPファイルそのものが記事
移行後
MariaDBに記事データを保存
+
PHPがDBから記事を取得して表示
→ 「記事データ」と「記事を表示するプログラム」を分けられるようになりました。
📝 今回の忘備録
DBにはtitle・slug・body・statusなどの記事データを保存し、 article-detail.php側で共通の表示処理とCSSを適用します。
preg_match()で必要な文字列を探す。preg_replace()で不要な部分を置き換える。新規記事は
INSERTする。既存記事は
UPDATEする。slugの重複を利用して、 新規記事と既存記事の処理を分けています。
この作業で分かったこと
- DBは記事データを保存する場所
- PHPはDBからデータを取得して表示できる
- 正規表現を使って文字列から必要な部分を探せる
- 記事本文とデザインは分離できる
- slugは記事を識別するために使える
- UNIQUE制約によって重複登録を防げる
- INSERTとUPDATEを使い分けられる
- draftとpublishedを分けることで公開前確認ができる
この先やること
- ログイン・認証を作る
- 管理画面を認証で保護する
- 管理者だけが記事を追加・編集・削除できるようにする