既存のPHP記事をCMSのDBへ移行する

PHPファイルで作っていた忘備録を、MariaDBのarticlesテーブルへ移行し、自作CMSから管理・表示できるようにします。

🎯 目的

これまでPHPファイルとして作ってきた忘備録を、CMSの記事としてMariaDBへ移行します。

移行後は、管理画面から記事を管理し、個別記事ページから表示できるようにします。

今回やること

  1. articlesテーブルの構造を確認する
  2. 既存のPHP記事を確認する
  3. インポート用PHPを作る
  4. PHPファイルからtitleと本文を取得する
  5. MariaDBへ記事を登録する
  6. 既存記事の場合はUPDATEする
  7. article-detail.phpの共通CSSで表示する
  8. 管理画面から記事を確認する
PHPファイル
↓
インポート処理
↓
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:記事ID
  • title:記事タイトル
  • slug:記事URL用の識別子
  • body:記事本文
  • status:draft / published
  • created_at:作成日時
  • updated_at:更新日時
📘 UNIQUE制約
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()とは
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()を読む
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
    (?, ?, ?, ?)
📘 SQLを読む
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 = ?
📘 SQLを読む
UPDATE articles = articlesテーブルの既存データを更新します。
SET = 変更するカラムと値を指定します。
title = ? = titleを新しい値へ変更します。
body = ? = bodyを新しい値へ変更します。
WHERE slug = ? = 指定したslugの記事だけを更新します。

→ 同じslugの記事を新しく増やすのではなく、すでにある記事の内容を更新します。

このときstatusは変更しません。

001はすでにpublishedだったため、再インポートしてもpublishedのままです。

📘 INSERTとUPDATEの使い分け
slugがDBに存在しない
→ INSERT

slugがDBに存在する
→ UPDATE

→ 同じインポーターを再実行しても、同じslugの記事を重複して増やさず、既存記事を更新できる仕組みにしています。
📘 科目Bにつなげる:条件分岐
処理を日本語で考えると、

slugはすでに存在するか?
↓
YES → UPDATE
NO → INSERT

→ 条件によって実行する処理を切り替える、典型的な分岐です。

STEP 8|記事本文とCSSを分離する

DBには記事本文のHTMLを保存し、記事全体の見た目は article-detail.phpの共通CSSで管理します。

DB
↓
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構造

PHPファイル
↓
title・本文を抽出
↓
slugが存在するか確認
↓
INSERT または UPDATE
↓
MariaDB / articles
↓
admin.php
↓
article-detail.php + 共通CSS
↓
ブラウザ

📘 処理の流れを読む

今回は「既存のPHP記事をCMSのデータへ変換する」処理です。

入力:記事番号をインポーターへ渡す
↓
処理①:対象のPHPファイルを読む
↓
処理②:正規表現でtitleと本文を取り出す
↓
処理③:本文から重複するh1を除外する
↓
条件判定:同じslugの記事がDBに存在するか確認する
↓
分岐:存在しない → INSERT / 存在する → UPDATE
↓
保存:MariaDBのarticlesテーブルへ保存する
↓
出力:article-detail.phpで記事として表示する

→ 「入力 → 抽出 → 加工 → 判定 → 保存 → 表示」という流れになっています。

📘 今回は「データ移行」

元の記事はPHPファイルの中にありました。
それを読み取り、CMSで扱える形にしてMariaDBへ保存しました。

移行前
PHPファイルそのものが記事

移行後
MariaDBに記事データを保存
+
PHPがDBから記事を取得して表示

→ 「記事データ」と「記事を表示するプログラム」を分けられるようになりました。

📝 今回の忘備録

記事の「内容」と「表示の仕組み」を分離しました。

DBにはtitle・slug・body・statusなどの記事データを保存し、 article-detail.php側で共通の表示処理とCSSを適用します。

preg_match()で必要な文字列を探す。
preg_replace()で不要な部分を置き換える。
新規記事はINSERTする。
既存記事はUPDATEする。

slugの重複を利用して、 新規記事と既存記事の処理を分けています。

この作業で分かったこと

この先やること

タグ: PHP / MariaDB / SQL / PDO / CRUD / CMS / 正規表現 / preg_match / preg_replace / INSERT / UPDATE / slug / draft / published