ルーティングの基本

ルーティングとは何か

ルーティングとは「どのURLに、どのHTTPメソッドでアクセスが来たら、どの処理を動かすか」を対応づける表のことです。ブラウザやアプリから届いたリクエストは、まずこのルーティング定義を見て「行き先」を決められます。リクエストライフサイクル の入口にあたる、アプリの交通整理役だと考えてください。

Laravelでは、ルート定義は「routes」ディレクトリに置かれた設定ファイルにまとめて書きます。画面(HTML)を返す普通のWebアクセス向けは「web.php」、JSONを返すAPI向けは「api.php」と、用途でファイルが分かれているのが特徴です。

HTTPメソッドとルート定義

同じURLでも、HTTPメソッド(GET・POST・PUT・PATCH・DELETE)が違えば意味が変わります。GETは「取得(見るだけ)」、POSTは「新規作成」、PUT/PATCHは「更新」、DELETEは「削除」というように、メソッドが操作の種類を表します。ルートはこの「URL × メソッド」の組で登録します。

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

// GET /posts        → 一覧を表示
Route::get('/posts', [PostController::class, 'index']);

// GET /posts/create → 新規作成フォームを表示
Route::get('/posts/create', [PostController::class, 'create']);

// POST /posts       → 送信された内容を保存
Route::post('/posts', [PostController::class, 'store']);

名前付きルート

ルートには「名前」を付けられます。URLの文字列そのものではなく、この名前を使ってリンクやリダイレクト先を組み立てられます。こうしておくと、あとでURLの綴りを変えても、名前さえ同じなら参照側を直さずに済みます。

Route::get('/posts/{post}', [PostController::class, 'show'])
    ->name('posts.show');

// 別の場所ではURL文字列ではなく「名前」で参照する
$url = route('posts.show', ['post' => 10]); // => /posts/10

RESTfulリソースルート

投稿・ユーザー・商品のような「リソース(資源)」に対する操作は、だいたい決まったパターン(一覧・詳細・作成フォーム・保存・編集フォーム・更新・削除)になります。Laravelはこの定番7アクションを1行でまとめて登録できる「リソースルート」を用意しています。

// これ1行で index / create / store / show / edit / update / destroy が登録される
Route::resource('posts', PostController::class);

// 確認: どんなルートが生えたかはコマンドで一覧できる
// $ php artisan route:list