TOPの検索をARTICLESとCOLUMNSの横断検索にする

TOPページの検索機能を拡張して、ARTICLESだけでなく公開済みのCOLUMNSも検索できるようにします。

🎯 目的

COLUMNSを公開できるようになりましたが、 TOPページの検索窓では ARTICLESしか検索できませんでした。

今回は既存の検索処理を拡張して、 ARTICLESとCOLUMNSの両方を 1つの検索窓から探せるようにします。

その過程で、 「別々のテーブルから取得したデータを、 PHPで1つの検索結果として扱う」 仕組みも確認します。

今回やること

  1. これまでの検索処理を確認する
  2. ARTICLESを検索する
  3. 公開済みのCOLUMNSを検索する
  4. 2つの検索結果を1つにまとめる
  5. 記事の種類によってリンク先を切り替える
  6. ARTICLESだけ記事番号を表示する
TOPの検索窓
↓
検索キーワード
↓
ARTICLESを検索 + COLUMNSを検索
↓
検索結果を1つにまとめる
↓
記事の種類を確認
↓
正しい個別ページへリンクする

STEP 1|これまでの検索処理を確認する

まず、変更前のTOPページでは ARTICLESを次のように検索していました。

$stmt = $pdo->prepare(
    'SELECT article_number, title, filename
     FROM textbook_articles
     WHERE title LIKE :keyword
     ORDER BY article_number DESC'
);

$stmt->execute([
    ':keyword' => '%' . $keyword . '%'
]);

$searchResults = $stmt->fetchAll();
📘 SQLを読む

SELECT = データベースから取得したい列を指定します。

article_number, title, filename = 記事番号・タイトル・ファイル名を取得します。

FROM textbook_articles = ARTICLESを管理している textbook_articlesテーブルから取得します。

WHERE = 取得するデータに条件を付けます。

title LIKE :keyword = titleに検索キーワードを含む記事を探します。

ORDER BY article_number DESC = article_numberの大きい記事から順番に並べます。

→ このSQLでは、 ARTICLESの中からタイトルに検索キーワードを含む記事を探し、 記事番号の大きい順に取得します。

📘 prepare() → execute() → fetchAll() を読む

$pdo->prepare() = SQLを実行できる形に準備します。

:keyword = あとから検索キーワードを渡すための プレースホルダーです。

'%' . $keyword . '%' = 検索キーワードの前後に %を付けます。

SQLのLIKEで使う %は、 「0文字以上の任意の文字」を表します。

たとえば $keywordが PHPなら、 %PHP%として検索します。

$stmt->execute() = prepare()で準備したSQLに値を渡して実行します。

$stmt->fetchAll() = 見つかった検索結果をすべてPHPへ取り出します。

→ このコード全体では、 検索キーワードをSQLへ渡してARTICLESを検索し、 見つかった記事を $searchResultsへ入れています。

ここで問題になるのは、 検索しているテーブルが textbook_articlesだけという点です。

COLUMNSは別の articlesテーブルに保存されています。

そのため、 COLUMNSを作っただけでは TOPの検索結果には出てきません。

STEP 2|ARTICLESを検索する

ARTICLESとCOLUMNSをあとで1つにまとめられるように、 ARTICLES側の検索結果へ 新しい情報を追加します。

$stmt = $pdo->prepare(
    'SELECT
        article_number,
        title,
        filename,
        NULL AS slug,
        "article" AS content_type
     FROM textbook_articles
     WHERE title LIKE :keyword'
);

$stmt->execute([
    ':keyword' => '%' . $keyword . '%'
]);

$articleResults = $stmt->fetchAll(PDO::FETCH_ASSOC);
📘 SELECTする項目を読む

article_number = ARTICLESの記事番号です。

title = 記事タイトルです。

filename = article-024.php のような個別記事のファイル名です。

→ ARTICLESの表示やリンク作成に必要な情報を データベースから取得しています。

📘 NULL AS slug を読む

NULL = 値がないことを表します。

AS = SQLで列に別名を付けます。

slug = COLUMNSの個別記事を特定するときに使う値です。

ARTICLESではslugを使わないため、 値は NULLにします。

→ ARTICLESには本来slugがありませんが、 NULL AS slugと書くことで、 COLUMNS側と同じ slugという項目を持たせています。

📘 "article" AS content_type を読む

"article" = この検索結果がARTICLESであることを表す値です。

AS content_type = その値に content_type という列名を付けます。

→ 検索結果の中に content_type = article という目印を追加しています。

この目印は、 ARTICLESとCOLUMNSを1つにまとめたあとで 「これはどちらの記事か」を判断するために使います。

📘 fetchAll(PDO::FETCH_ASSOC) を読む

fetchAll() = SQLで見つかったすべての結果を取得します。

PDO::FETCH_ASSOC = 列名をキーにした連想配列として取得します。

たとえばタイトルなら、 $article['title'] のように取り出せます。

$articleResults = ARTICLESの検索結果を保存する変数です。

→ このコード全体では、 ARTICLESを検索し、 あとでCOLUMNSと同じ形で扱いやすい検索結果を $articleResultsへ保存しています。

STEP 3|公開済みのCOLUMNSを検索する

次に、 COLUMNSが保存されている articlesテーブルを検索します。

$stmt = $pdo->prepare(
    'SELECT
        NULL AS article_number,
        title,
        NULL AS filename,
        slug,
        "column" AS content_type
     FROM articles
     WHERE status = :status
       AND title LIKE :keyword
     ORDER BY created_at DESC'
);

$stmt->execute([
    ':status' => 'published',
    ':keyword' => '%' . $keyword . '%'
]);

$columnResults = $stmt->fetchAll(PDO::FETCH_ASSOC);
📘 COLUMNS側のSELECTを読む

NULL AS article_number = COLUMNSにはARTICLES用の記事番号がないため、 article_numberには値を入れません。

title = COLUMNSのタイトルです。

NULL AS filename = COLUMNSは article-024.php のような個別ファイルを使わないため、 filenameには値を入れません。

slug = COLUMNSの個別記事を特定するための文字列です。

"column" AS content_type = この検索結果がCOLUMNSであることを示す 目印を追加します。

→ ARTICLES側と同じ項目を持たせながら、 COLUMNSに必要なslugも取得しています。

📘 WHERE status = :status AND title LIKE :keyword を読む

WHERE = 検索するデータに条件を付けます。

status = :status = statusが指定した値と一致する記事だけに絞ります。

AND = 前後の両方の条件を満たす、 という意味です。

title LIKE :keyword = タイトルに検索キーワードを含む記事だけに絞ります。

':status' => 'published' = :statusへ publishedを渡します。

→ 公開済みで、 なおかつタイトルに検索キーワードを含む COLUMNSだけを探しています。

📘 ORDER BY created_at DESC を読む

ORDER BY = 検索結果を並べ替えます。

created_at = 記事を作成した日時です。

DESC = 大きい値から小さい値へ並べます。 日時の場合は新しいものが先になります。

→ 見つかったCOLUMNSを、 新しい記事から順番に並べています。

📘 $columnResults を読む

$stmt->fetchAll(PDO::FETCH_ASSOC) で、 COLUMNSの検索結果をすべて取得します。

その結果を $columnResults という変数へ保存します。

→ このコード全体では、 公開済みのCOLUMNSから タイトルに検索キーワードを含む記事を探し、 その結果を $columnResultsへ保存しています。

STEP 4|ARTICLESとCOLUMNSを1つにまとめる

ここまでで、 ARTICLESとCOLUMNSを 別々に検索できました。

次は2つの検索結果を 1つにまとめます。

$searchResults = array_merge(
    $articleResults,
    $columnResults
);
📘 array_merge()を読む

array_merge() = 複数の配列を1つにつなげるPHPの関数です。

$articleResults = ARTICLESを検索した結果です。

$columnResults = COLUMNSを検索した結果です。

$searchResults = 2つをまとめたあとの検索結果を保存する変数です。

→ ARTICLESとCOLUMNSを別々に検索したあと、 2つの検索結果を1つにまとめています。

データベースでは別々のテーブルに保存されていても、 PHP側では1つの配列として扱えるようになりました。

STEP 5|記事の種類によってリンク先を切り替える

検索結果は1つになりましたが、 ARTICLESとCOLUMNSでは 個別ページのURLが違います。

そこで content_typeを確認して、 URLを切り替えます。

if ($article['content_type'] === 'column') {
    $resultUrl = '/column-detail.php?slug='
        . urlencode($article['slug']);
} else {
    $resultUrl = '/'
        . $article['filename'];
}
📘 if と content_type を読む

if = 「もしこの条件なら」というPHPの条件分岐です。

$article['content_type'] = 検索結果に付けた記事の種類を取り出します。

=== = 値と型の両方が同じかを比較します。

'column' = COLUMNSであることを表す値です。

→ 「この検索結果はCOLUMNSか?」を確認しています。

📘 COLUMNSのURLを読む

$resultUrl = 検索結果をクリックしたときのURLを保存する変数です。

/column-detail.php?slug= = COLUMNSの個別ページを開くためのURLです。

$article['slug'] = 開きたいCOLUMNSを特定するslugです。

urlencode() = 文字列をURLの中で安全に扱える形へ変換する PHPの関数です。

. = PHPで文字列同士をつなげます。

→ COLUMNSの場合は、 column-detail.phpへslugを渡すURLを作っています。

📘 else と ARTICLESのURLを読む

else = ifの条件に当てはまらなかった場合の処理です。

今回はCOLUMNSでなければ、 ARTICLESとして扱います。

$article['filename'] = ARTICLESの個別ページのファイル名です。

→ ARTICLESならファイル名、 COLUMNSならslugを使って、 それぞれ正しい個別ページのURLを作っています。

STEP 6|ARTICLESだけ記事番号を表示する

ARTICLESには 001、 002のような記事番号があります。

COLUMNSには同じ記事番号がないため、 ARTICLESの場合だけ表示します。

<?php if ($article['content_type'] === 'article'): ?>

    <span class="article-number">
        <?= sprintf(
            '%03d',
            $article['article_number']
        ) ?>
    </span>

<?php endif; ?>
📘 if (...) : と endif を読む

if ($article['content_type'] === 'article') = 検索結果がARTICLESか確認します。

: = HTMLの中でifを書くときに使える PHPの書き方です。

endif; = ifの処理がここまでであることを表します。

→ ARTICLESの場合だけ、 ifからendifまでのHTMLを表示します。

📘 sprintf('%03d', ...) を読む

sprintf() = 指定した形式に合わせて文字列を作る PHPの関数です。

%d = 整数を表示します。

3 = 3桁で表示します。

0 = 足りない桁を0で埋めます。

そのため %03dは、 「整数を3桁にして、足りない桁を0で埋める」 という意味になります。

たとえば 24なら 024になります。

$article['article_number'] = ARTICLESの記事番号です。

→ ARTICLESの場合だけ記事番号を取り出して、 001、002、024のような3桁の形式で表示しています。

📘 コード全体の流れを読む

入力
TOPページの検索窓へキーワードを入力します。

↓

処理1
textbook_articlesから ARTICLESを検索します。

↓

処理2
articlesから 公開済みのCOLUMNSを検索します。

↓

処理3
array_merge()で ARTICLESとCOLUMNSの検索結果を 1つにまとめます。

↓

処理4
content_typeを見て、 ARTICLESなのかCOLUMNSなのかを判断します。

↓

出力
ARTICLESとCOLUMNSを 1つの検索結果としてTOPページへ表示し、 それぞれ正しい個別ページへリンクします。

今回わかったこと

COLUMNSという新しい機能を作っても、 既存の検索機能が自動で対応するわけではありません。

「検索に出てこない」ときは、 まず検索処理が どのテーブルを見ているのか を確認します。

今回はARTICLESとCOLUMNSを それぞれのテーブルから検索し、 PHPの array_merge()で 1つにまとめました。

さらに content_typeという目印を付けることで、 まとめたあとでも ARTICLESとCOLUMNSを区別できました。

またCOLUMNSでは status = published を検索条件に入れることで、 下書きや公開依頼中の記事が TOPの検索結果へ出ないようにしています。

📝 忘備録

この先やること

タグ: PHP / SQL / MariaDB / PDO / LIKE / array_merge / content_type / ARTICLES / COLUMNS / 検索