TOPの検索をARTICLESとCOLUMNSの横断検索にする
TOPページの検索機能を拡張して、ARTICLESだけでなく公開済みのCOLUMNSも検索できるようにします。
🎯 目的
COLUMNSを公開できるようになりましたが、 TOPページの検索窓では ARTICLESしか検索できませんでした。
今回は既存の検索処理を拡張して、 ARTICLESとCOLUMNSの両方を 1つの検索窓から探せるようにします。
その過程で、 「別々のテーブルから取得したデータを、 PHPで1つの検索結果として扱う」 仕組みも確認します。
今回やること
- これまでの検索処理を確認する
- ARTICLESを検索する
- 公開済みのCOLUMNSを検索する
- 2つの検索結果を1つにまとめる
- 記事の種類によってリンク先を切り替える
- ARTICLESだけ記事番号を表示する
↓
検索キーワード
↓
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();
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の中からタイトルに検索キーワードを含む記事を探し、 記事番号の大きい順に取得します。
$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);
article_number
= ARTICLESの記事番号です。
title
= 記事タイトルです。
filename
=
article-024.php
のような個別記事のファイル名です。
→ ARTICLESの表示やリンク作成に必要な情報を データベースから取得しています。
NULL
= 値がないことを表します。
AS
= SQLで列に別名を付けます。
slug
= COLUMNSの個別記事を特定するときに使う値です。
ARTICLESではslugを使わないため、
値は
NULLにします。
→ ARTICLESには本来slugがありませんが、
NULL AS slugと書くことで、
COLUMNS側と同じ
slugという項目を持たせています。
"article"
= この検索結果がARTICLESであることを表す値です。
AS content_type
= その値に
content_type
という列名を付けます。
→ 検索結果の中に
content_type = article
という目印を追加しています。
この目印は、 ARTICLESとCOLUMNSを1つにまとめたあとで 「これはどちらの記事か」を判断するために使います。
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);
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
= statusが指定した値と一致する記事だけに絞ります。
AND
= 前後の両方の条件を満たす、
という意味です。
title LIKE :keyword
= タイトルに検索キーワードを含む記事だけに絞ります。
':status' => 'published'
=
:statusへ
publishedを渡します。
→ 公開済みで、 なおかつタイトルに検索キーワードを含む COLUMNSだけを探しています。
ORDER BY
= 検索結果を並べ替えます。
created_at
= 記事を作成した日時です。
DESC
= 大きい値から小さい値へ並べます。
日時の場合は新しいものが先になります。
→ 見つかったCOLUMNSを、 新しい記事から順番に並べています。
$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()
= 複数の配列を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
= 「もしこの条件なら」というPHPの条件分岐です。
$article['content_type']
= 検索結果に付けた記事の種類を取り出します。
===
= 値と型の両方が同じかを比較します。
'column'
= COLUMNSであることを表す値です。
→ 「この検索結果はCOLUMNSか?」を確認しています。
$resultUrl
= 検索結果をクリックしたときのURLを保存する変数です。
/column-detail.php?slug=
= COLUMNSの個別ページを開くためのURLです。
$article['slug']
= 開きたいCOLUMNSを特定するslugです。
urlencode()
= 文字列をURLの中で安全に扱える形へ変換する
PHPの関数です。
.
= PHPで文字列同士をつなげます。
→ COLUMNSの場合は、 column-detail.phpへslugを渡す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 ($article['content_type'] === 'article')
= 検索結果がARTICLESか確認します。
:
= HTMLの中でifを書くときに使える
PHPの書き方です。
endif;
= ifの処理がここまでであることを表します。
→ ARTICLESの場合だけ、 ifからendifまでのHTMLを表示します。
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の検索結果へ出ないようにしています。
📝 忘備録
- 新しいコンテンツを追加したら、既存の検索機能も確認する
- 別テーブルの検索結果でも、配列の形をそろえると扱いやすい
- array_merge()で複数の検索結果を1つにまとめられる
- content_typeを持たせると、まとめたあとでも種類を判別できる
- 公開画面ではstatus = publishedを忘れない
- 機能だけでなく「その機能へどう到達するか」も確認する
この先やること
- COLUMNSの記事数が増えたらページネーションを検討する
- 検索対象を本文まで広げるか検討する
- 実際に使いながら検索結果の見せ方を改善する