はじめに

URLの末尾に?page=2や'?q=Laravel&sort=asc' のようなものを見かけることは多いです。
これは「クエリ文字列(query string)」と呼ばれ、Webアプリに情報を渡すための仕組みです。
今回は、クエリ文字列の基本的な仕組みや、PHP・Laravelでの扱い方についてまとめます。

①クエリ文字列とは？

クエリ文字列とは、URLの末尾に?をつけて、キー=値の形式で情報を渡す仕組みです。

例:

q=Laravel→検索キーワードが"Laravel"
page=2 → 2ページ目の表示

特徴:

複数の値は&でつなぐ
すべて文字列として扱われる
ブラウザのアドレスバーに表示されるため、再読み込み・共有がしやすい

②クエリ文字列の構造

部分	意味
`?`	クエリ文字列の始まり
`&`	複数のパラメータを区切る
`=`	キーと値をつなぐ

クエリ文字列の用途例

検索フォーム：/search?q=Laravel
ページネーション：/posts?page=3
並び替え：/products?sort=price_asc
フィルタ：/items?category=books&price=under_1000

PHPでの取得方法

$keyword = $_GET['q'];     // Laravel
$page = $_GET['page'];     // 2

$_GETはPHPのスーパーグローバル変数
クエリ文字列をキーとして取得できる

③Laravelでの取得方法

Laravelでは、Requestクラスを使って取得します。

use Illuminate\Http\Request;

public function search(Request $request)
{
    $keyword = $request->query('q');      // "Laravel"
    $page = $request->query('page');      // "2"
}

もしくは:

$request->input('q'); //クエリ・POST　どちらも対象

④Bladeテンプレートでの活用例

ページネーション時に現在のクエリを維持:

{{ $posts->appends(request()->query())->links()}}

→検索ワードなどを保持したままページネーション可能

⑤クエリ文字列を生成するには？

$url = route('search',['q' => 'Laravel', 'page' => 2]);

Laravelのroute()やurl()ヘルパーでクエリを付与可能です。

⑥まとめ

クエリ文字列は、ユーザーとアプリをつなぐ情報の橋渡しのような存在です。
LaravelやPHPでの取得・保持・生成の方法を知っておくことで、より動的で便利なWebアプリが作れるようになります！