Laravelでフォームを作る基本の方法（Blade + POSTリクエスト）

1. ルートとコントローラを準備しよう

1. ルートとコントローラを準備しよう

Laravelでフォーム機能を実装するには、まず「どのURLにアクセスしたら」「どのプログラム（コントローラ）を動かすか」という交通整理の設定が必要です。これをルーティングと呼びます。

まずは、ブラウザで表示するための設定と、送信ボタンを押した後の設定をroutes/web.phpに追記しましょう。

use App\Http\Controllers\FormController;
use Illuminate\Support\Facades\Route;

// フォームの画面を表示するためのルート（GETリクエスト）
Route::get('/contact', [FormController::class, 'showForm']);

// フォームのデータを受け取るためのルート（POSTリクエスト）
Route::post('/contact', [FormController::class, 'submitForm']);

次に、実際の処理を担当する「コントローラ」を作成します。Laravelでは、職人（Artisan）コマンドを使って雛形を自動生成するのが一般的です。ターミナル（WindowsならコマンドプロンプトやPowerShell）を開き、プロジェクトのフォルダで以下のコマンドを入力してください。

php artisan make:controller FormController

コマンドを実行すると、app/Http/Controllers/FormController.phpというファイルが作成されます。この中に、先ほどルートで指定した「表示用（showForm）」と「受信用（submitForm）」の2つの動きを書き込んでいきます。

namespace App\Http\Controllers;

// Requestクラスを読み込むことで、送信されたデータを取り扱えるようになります
use Illuminate\Http\Request;

class FormController extends Controller
{
    // お問い合わせ画面（入力画面）を表示する魔法
    public function showForm()
    {
        // resources/views/contact.blade.php を表示します
        return view('contact');
    }

    // 送信されたデータを受け取って処理する魔法
    public function submitForm(Request $request)
    {
        // $requestの中に、ユーザーが入力した「名前」や「メール」が全て入っています
        $data = $request->all();

        // 開発中は、このように中身をのぞいて確認してみましょう
        return 'フォームから無事にデータが届きました：' . json_encode($data);
    }
}

プログラミング未経験の方は、まず「GETは画面を見るため」「POSTはデータを送るため」という使い分けを意識するだけでOKです。これでデータの通り道が完成しました。

2. Bladeテンプレートでフォームを作る

2. Bladeテンプレートでフォームを作る

データの受け皿（コントローラ）ができたら、次はユーザーが情報を入力する「見た目」の部分、Bladeテンプレートを作成しましょう。作成場所はresources/views/contact.blade.phpです。

Laravelでフォームを作成する際、最も重要なのが@csrfという記述です。これは「クロスサイト・リクエスト・フォージェリ」という攻撃からサイトを守るためのセキュリティ対策で、これがないとLaravelは安全のためにデータを書き換える処理を拒否してしまいます。初心者が一番つまずきやすいポイントなので、必ず入れる癖をつけましょう。

以下は、名前、メールアドレス、メッセージを入力するためのシンプルなフォームの例です。HTMLに慣れていない方でも、各inputタグのname属性が、後ほどコントローラでデータを取り出す際の「キー（名前）」になることだけ意識しておけば大丈夫です。

<form action="/contact" method="POST">
    @csrf

    <div class="mb-3">
        <label for="name" class="form-label">名前:</label>
        <input type="text" id="name" name="name" class="form-control" placeholder="山田 太郎">
    </div>

    <div class="mb-3">
        <label for="email" class="form-label">メールアドレス:</label>
        <input type="email" id="email" name="email" class="form-control" placeholder="example@test.com">
    </div>

    <div class="mb-3">
        <label for="message" class="form-label">メッセージ:</label>
        <textarea id="message" name="message" class="form-control" rows="3"></textarea>
    </div>

    <button type="submit" class="btn btn-primary">送信する</button>
</form>

ポイント： name="name" や name="email" という属性が、サーバー側でデータを受け取る際の識別票になります。ここを間違えると、せっかく入力したデータが迷子になってしまうので注意しましょう。これで、ブラウザからデータを送る準備が整いました。

3. 入力データを取得して処理する

3. 入力データを取得して処理する

送信されたデータはコントローラのRequestオブジェクトから取得できます。$request->all()で全データを取得し、個別に取り出すことも可能です。

public function submitForm(Request $request)
{
    $name = $request->input('name');
    $email = $request->input('email');
    $message = $request->input('message');

    // ここでDBに保存したりメール送信したりできます
    return "こんにちは、{$name}さん。送信完了しました。";
}

4. フォームバリデーションの基本

4. フォームバリデーションの基本

フォーム入力時に必須チェックや形式チェックを行いたい場合は、Laravelのバリデーション機能を使います。$request->validate()で簡単にチェックできます。

public function submitForm(Request $request)
{
    $validated = $request->validate([
        'name' => 'required|max:50',
        'email' => 'required|email',
        'message' => 'required',
    ]);

    return "バリデーション通過しました: " . json_encode($validated);
}

バリデーションに失敗した場合、自動的に元のフォームにリダイレクトされ、エラーメッセージが表示されます。

5. まとめずに次のステップに進むポイント

5. まとめずに次のステップに進むポイント

この基本を理解すれば、Laravelでフォームを簡単に作り、POSTリクエストでデータを受け取れるようになります。Bladeテンプレート、CSRFトークン、コントローラのRequestオブジェクトを組み合わせることが重要です。