WordPressの検索語を安全に表示する。get_search_query()の役割を理解する

2026年10月7日2026年10月18日

CODE

WordPressの検索結果ページでは、「何を検索した結果なのか」を画面へ残す必要があります。検索フォームから送られた文字をそのまま表示するだけに見えますが、URLから受け取った値をHTMLへ出す処理でもあります。

PROJECT 002で検索画面を作ったあと、検索語を取得するget_search_query()の役割を調べました。この記事では、検索語がどこから来て、どの場所へ、どの形で表示されるのかを最小例で確認します。

検索フォームのname=”s”が検索語になる

WordPressの標準検索では、入力欄の名前にsを使います。たとえば「バックアップ」と入力して送信すると、URLは次のような形になります。

https://example.com/?s=バックアップ

このsが、WordPressの検索クエリ変数です。get_search_query()は、その内容をテンプレート側で受け取るための関数です。

まずは検索フォームと結果表示を分ける

検索では、同じ文字列が二つの場所に現れます。

場所	役割	HTML上の位置
検索フォーム	直前の検索語を入力欄へ残す	value属性
検索結果の見出し	何を検索した結果か伝える	要素の本文

見た目は同じ検索語でも、HTML属性へ入れる場合と、本文として表示する場合では文脈が違います。ここを分けて考えると、エスケープの役割を理解しやすくなります。

入力欄ではget_search_query()を使う

検索フォームの最小例は次の形です。

<form role="search" method="get" action="<?php echo esc_url( home_url( '/' ) ); ?>">
  <label for="portal-search">サイト内検索</label>
  <input
    id="portal-search"
    type="search"
    name="s"
    value="<?php echo get_search_query(); ?>"
  >
  <button type="submit">検索</button>
</form>

get_search_query()は初期値では、取得した検索語をesc_attr()へ通して返します。つまり、HTML属性のvalueへ置くことを想定した形です。

WordPress標準の検索フォームも、入力欄の値にこの関数を使っています。検索後も入力欄へ検索語が残るため、利用者は条件を少し変えて検索し直せます。

結果見出しでは本文としてエスケープする

検索結果の見出しでは、検索語をHTML属性ではなく、文章の一部として表示します。文脈を明確にするなら、未エスケープの値を取得し、本文用のesc_html()を使えます。

<h1>
  「<?php echo esc_html( get_search_query( false ) ); ?>」の検索結果
</h1>

falseを渡すと、get_search_query()は関数内でesc_attr()を行わずに返します。その値を、表示先に合うesc_html()へ通しています。

公式ドキュメントも、未エスケープの値は後で適切にエスケープする場合だけ使い、未処理のまま出力しないよう説明しています。

取得と表示を一度に混ぜない

検索語を複数箇所で使う場合は、変数へ入れて役割を分けると追いやすくなります。

<?php
$search_query = get_search_query( false );
?>

<h1>
  「<?php echo esc_html( $search_query ); ?>」の検索結果
</h1>

<p>
  <?php echo esc_html( $search_query ); ?> に一致する情報を表示しています。
</p>

この例では、取得する処理は一度だけです。表示する場所ごとにesc_html()を使うため、「今は本文へ出している」とコードから分かります。

よくある混乱を三つに分ける

混乱	確認すること
検索語が空になる	検索結果ページか、URLにsがあるか
入力欄へ検索語が残らない	value属性にget_search_query()があるか
エスケープが分からない	HTML属性か、要素本文かを先に決める

get_search_query()は検索そのものを実行する関数ではありません。検索対象や並び順を変える役割でもありません。現在の検索語を、テンプレートで使える形にして取得する関数です。

検索結果が変わらないときに、この関数だけを調整しても検索条件は変わりません。取得・表示と、検索クエリの変更を分けることが大切です。