【コピペで使える】PHPで作る検索フォーム実装サンプル

今回はPHPで検索ページを作るベースとなるサンプルコードをご紹介したいと思います。

1 検索ページとは
2 処理のフロー
3 サンプルコード
- 3.1 POSTを使ったサンプルコード（search_post.php）
- 3.2 GETを使ったサンプルコード（search_get.php）
4 POSTとGETどちらがよい？

検索ページとは

ウェブアプリケーションにおいて検索ページ（検索フォーム）というのは必要不可欠なものです。

例えば賃貸物件を紹介するウェブサイトなどでは膨大な物件の中から自分に合った物件を探すために検索機能が必要ですし、顧客管理システムなどでも顧客を効率よく探すために検索フォームが必要になります。

しかしながらこの検索ページ、いざスクラッチで実装しようとすると意外と厄介なもので、しっかりと定型化しておかないと毎回悩むことになります。

そんなわけで今回備忘録も兼ねて、比較的過不足なく動くシンプルなコードをまとめてみました。

処理のフロー

検索ページにおけるアクセスは大きく分けて、

・検索実行時のアクセス
・通常時のアクセス

上記二通りがあります。

通常時のアクセスでは検索フォームはデフォルト値を設定し、検索フォーム設定後「検索ボタン」を押すとその内容に応じて絞り込んだリストを出力するといった流れです。

サンプルコード

POSTを使ったサンプルコード（search_post.php）


<?php
session_start();

// 検索時のアクセス
if($_POST['mode'] == "search"){

  // セッションを初期化
  $_SESSION['search'] = array();
  // セッションに入力値を入れる
  $_SESSION['search']['name'] = $_POST['name'];
  // データベース検索
  $content = getUserList($_SESSION['search']['name']);

// 通常時のアクセス
} else {

  // 初回のアクセス
  if(empty($_SESSION['search'])){
    // セッションにデフォルト値設定
    $_SESSION['search']['name'] = "";
  }
  // データベース検索
  $content = getUserList($_SESSION['search']['name']);

}
?>
<html>
<head></head>
<body>

  <h1>検索処理ページサンプル</h1>

  <h2>検索フォーム</h2>
  <div id="search-area">
    <form name="search" action="./search_post.php" method="post">
      <table>
      <tr>
        <th>名前</th>
        <td>
          <input type="text" id="name" name="name" value="<?php if(!empty($_SESSION[['search']['name'])){ echo $_SESSION['search']['name']; } ?>" placeholder="名前" />
        </td>
      </tr>
      </table>
      <input type="hidden" name="mode" value="search" />
      <p><input type="submit" id="search" name="search" value="この条件で検索する" /></p>
    </form>
  </div>

  <h2>検索結果</h2>
  <?php if(!empty($content)){ ?>
    <table>
    <?php foreach($content as $value){ ?>
      <tr>
        <td>
          <?php echo $value['name']; ?>
        </td>
      </tr>
    <?php } ?>
    </table>
  <?php } else { ?>
    <p>検索結果がありません。</p>
  <?php } ?>

</body>
</html>

一回の検索処理だけであればもっとシンプルですが、続けての検索を想定すると検索情報は保持したいためPOSTで送信された検索情報をセッションで保持するようにしています。

また検索一覧でのページ送りの処理を行う場合、異なるページ間で検索条件を引き継ぐ必要がありますのでセッションによる情報の保持、または、hidden属性による検索条件の保持が必要となってきます。

GETを使ったサンプルコード（search_get.php）

準備中です。

POSTとGETどちらがよい？

ユーザー画面側での検索フォームでは基本的にはPOSTよりもGETでの実装の方が使い勝手がよいと思います。

GETの場合はURLの引数として検索情報を付加できますので、特定の検索結果にURLで直接アクセスさせることができること、また検索エンジンに特定の条件での検索結果ページごとに認識させることができるためSEO上も強くなるからです。

POSTの場合上記のようなことはできませんし、また検索結果ページを更新した場合にエラー表示となりスムーズにページを表示できないこともデメリットのひとつです。

一般ユーザーに公開しない管理画面での実装であればPOSTでもよいと思います。