フォームの action とルート指定、基礎的なHTML構造も一緒に学びなおす

Posted at 2025-03-24

はじめに

Laravelで開発をしていると、Bladeテンプレート内で以下のようなコードをよく見かけます：

<form action="{{ route('replies.replycompleted', ['id' => $post->id]) }}" method="POST">

「これは何をしているの？」「HTMLの form タグってそもそも何？」と気になったので、LaravelとHTMLの基本をセットで学びなおした内容を備忘録としてまとめてみました。

まずは、HTMLの form タグについて復習します。

<form action="/送信先URL" method="POST">
    <input type="text" name="example">
    <button type="submit">送信</button>
</form>

Laravelでは、route() ヘルパーを使って、ルート名からURLを自動生成できます。

例:

action="{{ route('replies.replycompleted', ['id' => $post->id]) }}"

このコードは、routes/web.php に定義されたルートのURLを取得しています。
web.php 側の定義例：

Route::post('/reply/completed/{id}', [ReplyController::class, 'store'])->name('replies.replycompleted');

このようにルート名が 'replies.replycompleted' で、パラメータに id を取るルートに対して、
Blade内で route('replies.replycompleted', ['id' => $post->id]) を使うことで、以下のようなURLが生成されます：

/reply/completed/5

（※ $post->id が5だった場合）

Laravelで method="POST" を使うときは、CSRF（クロスサイトリクエストフォージェリ）対策として、必ず @csrf を入れる必要があります。

<form action="{{ route('replies.replycompleted', ['id' => $post->id]) }}" method="POST">
    @csrf
    <!-- フォーム内容 -->
</form>

これがないと、Laravel側で「419 Page Expired」エラーになります。