Laravel Requestをわかりやすく解説：フォームデータからバリデーションまで

バックエンド開発•
LaravelPHP

はじめに

Laravelでは、フレームワークがHTTPリクエストの受け取りからルーティングまでを効率的に行います。 その中でRequestクラスは、ユーザーから送信されたフォームデータやクエリパラメータ、ファイルなどを簡単に扱うための重要な役割を担っています。

とはいえ、初心者の皆さんは「Requestクラスって何をするものなのか」「どのように使えばよいのか」が少し難しく感じるかもしれません。 そこで今回は、LaravelにおけるRequestクラスの基本的な使い方を中心に、実務での活用シーンも含めてわかりやすく解説していきます。

短いサンプルコードを交えながら進めますので、初めてLaravelを触る方でも理解しやすいのではないでしょうか。 実際の開発シーンで役立つポイントも紹介しますので、ぜひ参考にしてみてください。

この記事を読むとわかること

  • LaravelにおけるRequestクラスの基本的な仕組み
  • フォームデータやクエリパラメータの取得方法
  • 実際のコード例を通じたバリデーションの流れ
  • API開発やファイルアップロードなどの実務に沿った活用方法

ここから順序立てて解説していきますので、段階的にRequestクラスの使い方を理解していきましょう。

Laravel Requestの概要

HTTPリクエストの基本

ブラウザやアプリケーションがサーバーとやり取りをする際には、HTTPリクエストという形式で情報を送受信します。 ユーザーがフォームに入力してボタンをクリックすると、その情報はHTTPリクエストに載せられてサーバーに到達します。 その後、サーバー側が受け取ったデータを解析し、必要な処理やレスポンスの生成を行います。

この流れ自体は、どんな言語やフレームワークでも似たようなものです。 Laravelでは、コントローラーのメソッドでこのリクエストを受け取り、さまざまな処理を行うのが基本の仕組みです。 このとき、リクエストの詳細な情報を取得したり、加工したりするためにRequestクラスが利用されます。

LaravelにおけるRequestの役割

Laravelのコントローラーでメソッドの引数にRequestクラスを指定すると、HTTPリクエストに関する便利なメソッドがたくさん使えます。 たとえば以下のような情報がすぐに取得できます。

  • フォームデータやクエリパラメータの値
  • アップロードされたファイル
  • リクエストのHTTPメソッド（GET、POSTなど）
  • ヘッダー情報（ユーザーエージェント、認証トークンなど）

こういった情報を用いて、ユーザーの入力内容に応じた処理やバリデーションを実行したり、特定のパラメータが存在するかどうかをチェックしたりします。 つまりRequestクラスがあるおかげで、コードの可読性や保守性を損なわずにリクエストの中身を扱えるのです。

Requestクラスの使い方

ルーティングとRequestクラス

まずはルーティングでコントローラーメソッドを紐付け、そこでRequestクラスを使う流れを見てみましょう。 例として、ユーザー情報を新規登録する場面を想定します。

// routes/web.php
use App\Http\Controllers\UserController;
use Illuminate\Support\Facades\Route;

Route::post('/users', [UserController::class, 'store']);

上記のようにRoute::postで「/usersパス」にPOSTリクエストが来たら、storeメソッドを呼び出すように設定しています。 そのstoreメソッドでRequestクラスを利用することで、ユーザーが送信したフォームデータを扱います。

フォームデータを取得してみる

コントローラー側のコードは以下のようになります。 例として、ユーザーの名前とメールアドレスを入力してもらうフォームを受け取るイメージです。

// app/Http/Controllers/UserController.php
namespace App\Http\Controllers;

use Illuminate\Http\Request;

class UserController extends Controller
{
    public function store(Request $request)
    {
        // フォームから送信された値を取得
        $name = $request->input('name');
        $email = $request->input('email');

        // もし特定のパラメータが存在しているかチェック
        if ($request->has('subscribe')) {
            // チェックボックスや購読に関する処理など
        }

        // 必要なロジックをここで実行（DBに登録するなど）
        // ユーザー作成処理の例（細かい実装は省略）
        // $user = new User();
        // $user->name = $name;
        // $user->email = $email;
        // $user->save();

        return response()->json([
            'message' => 'ユーザー登録が完了しました。',
            'name' => $name,
            'email' => $email,
        ]);
    }
}

$request->input('name')などのメソッドで、フォームに入力された値を簡単に取得できます。 もし、値が存在しない可能性がある場合でも、$request->has('xxx')を使うことで「そのパラメータが送信されているか」を事前にチェックできます。

クエリパラメータの扱い

GETリクエストでクエリパラメータが付与される場面を考えてみましょう。 URLがhttps://example.com/users?keyword=laravelのとき、以下のように取得が可能です。

public function index(Request $request)
{
    $keyword = $request->query('keyword', ''); // 指定がなければ空文字を返す
    // このkeywordを使ってユーザーを検索したり、必要に応じて処理を行う

    // ...
}

$request->query('keyword')でクエリパラメータを取得できますが、存在しない場合のデフォルト値を指定することもできます。

JSONリクエストへの対応

APIを作るときにはJSON形式のリクエストを受け取るケースが増えます。 LaravelのRequestクラスでは、JSONを送信されても通常のフォームデータとほぼ同じ感覚で扱うことができます。

public function store(Request $request)
{
    // JSONリクエストの場合もinputメソッドでOK
    $data = $request->input('data');
    // $dataの中身をもとに何らかの処理をする

    return response()->json([
        'status' => 'ok',
    ]);
}

特別な設定をしなくてもJSONリクエストに対応できるのは、Laravelの大きな利点の一つでしょう。 また、ヘッダー情報も$request->header('Authorization')のように簡単に取り出せるので、API開発全般で活躍してくれます。

バリデーションとRequestの組み合わせ

ユーザーがフォームに入力した内容をDBに保存したり、外部APIへ送信したりするときには、データの妥当性確認が欠かせません。 Laravelでは、コントローラーの中でバリデーションを行うことが一般的です。

public function store(Request $request)
{
    // バリデーションルールの例
    $validatedData = $request->validate([
        'name' => 'required|string|max:255',
        'email' => 'required|email|unique:users,email',
    ]);

    // バリデーションをパスすれば、$validatedDataに正しいデータが格納されます
    // 後はDBに保存するなどの処理を実行
    // ...

    return response()->json([
        'message' => 'バリデーションを通過しました',
        'data' => $validatedData
    ]);
}

validateメソッドを使うと、ルールに合致しない場合には自動的にエラーレスポンスが返されます。 初心者の皆さんにとっては便利ですが、いきなりエラー画面が表示されてびっくりするかもしれません。 エラーの表示をカスタマイズしたり、例外処理を書いたりする方法も用意されているので安心してください。

実務での活用シーン

フォーム送信

実務で最も多いシナリオの一つが、会員登録フォームやお問い合わせフォームなどの送信です。 Requestクラスのおかげで、フォームデータのバリデーションや保存処理までがシンプルにまとまります。 そのため、ページ数が多いプロジェクトでも可読性を維持しやすいというメリットがあります。

アップロード機能

画像やファイルのアップロード機能も、Requestクラスで簡単に実装できます。 たとえばアップロードされた画像を取得する場合には、以下のような書き方をします。

public function upload(Request $request)
{
    if ($request->hasFile('image')) {
        // ファイルがアップロードされていれば処理を行う
        $file = $request->file('image');
        $path = $file->store('public/images'); // storage/app/public/imagesに保存されるイメージ
        return response()->json(['path' => $path]);
    } else {
        return response()->json(['error' => 'ファイルがアップロードされていません。'], 400);
    }
}

ファイルの種類や容量の制限をバリデーションルールで設定することもできるので、実務上も安心です。 この方法は、ユーザーがプロフィール画像を登録するときなどに重宝するはずです。

API開発

近年はフロントエンドとバックエンドを切り離して開発するケースが増えています。 LaravelでAPIを構築し、ReactやVueなどのフロントエンドフレームワークと連携することも一般的です。 その際、JSON形式のやり取りが中心となりますが、Requestクラスを使ってパラメータやヘッダーを扱う流れは基本的に同じです。

API開発で認証が必要なときは、トークンやクッキーをリクエストヘッダーから取得して検証するケースが多いです。 その際もRequestクラスのメソッドで確認できるため、スムーズです。

ミドルウェアでの利用

Requestクラスは、ミドルウェアを使った一括処理でも活用できます。 アクセス制御やログ記録などを行いたい場合、ミドルウェア内でリクエスト情報をチェックし、特定の条件を満たさない場合は処理を中断するといった実装が可能です。 これにより、全ルートに対して共通の制限をかけたいときでも、コントローラーごとに重複したコードを書く必要がなくなります。

Requestクラスを使う際のポイント

パラメータ取得の優先順位

同じキーのデータがクエリパラメータとフォームデータで衝突するケースはあまり多くありませんが、複雑なフォームやAPI統合の場合に起きることがあります。 Laravelでは、フォームデータがクエリパラメータよりも優先されるなど、いくつかの内部的なルールがあります。 意図せず間違った値を拾わないようにするためにも、hasやinputメソッドを使うときには、データソースを意識しておくと良いでしょう。

セキュリティ面での考慮

リクエスト内容をそのまま信用してしまうと、意図しないSQL文を実行される危険性があり、SQLインジェクションなどのリスクにさらされることがあります。 Laravelでバリデーションを適切に組み込んでいれば、データの内容を検証できます。 また、クエリビルダやEloquentでパラメータをバインドする仕組みを使うことで、このリスクはかなり軽減できます。

リクエストデータは信頼できるとは限りません。 常に「不正な値が送られてくるかもしれない」という前提でバリデーションや消毒処理を行いましょう。

まとめ

LaravelにおけるRequestクラスは、フォーム送信やAPI開発など、さまざまな場面でデータを扱う要として機能します。 具体的には、以下のようなポイントを押さえておけば十分に活用できるでしょう。

  • $request->input()や$request->query()でパラメータ取得
  • $request->hasFile()や$request->file()でファイルアップロードに対応
  • $request->validate()でバリデーションを実施
  • JSONリクエストやヘッダー情報の取得も同様のメソッドで扱える

これらの基本を理解することで、実際のプロジェクトでもスムーズにLaravelの開発に着手できるのではないでしょうか。 複雑な機能を追加する場合でも、Requestクラスのメソッドとバリデーションを組み合わせれば、アプリケーションの品質や保守性が向上しやすくなります。

皆さんがLaravelでアプリケーションを作成する際には、ぜひRequestクラスを有効に使ってみてください。 リクエストの扱いがスマートになるだけでなく、全体の開発効率も高まりやすくなるはずです。

Laravelをマスターしよう

この記事で学んだLaravelの知識をさらに伸ばしませんか？
Udemyには、現場ですぐ使えるスキルを身につけられる実践的な講座が揃っています。

Laravelの人気講座ランキングを見る筆者おすすめ No.1 講座！「PHPからLaravelまで サーバーサイドをとことんやってみよう【初心者から脱初心者へ】【わかりやすさ最重視】」
バックエンド開発の新着記事をチェック

バックエンドエンジニア とは？仕事内容・必要スキル・将来性を徹底解説