ホーム>Laravel>Laravelのルーティングの書き方(web.php・パラメータ・route関数・グループ)
Laravel

Laravelのルーティングの書き方(web.php・パラメータ・route関数・グループ)

いつもご利用ありがとうございます。
この記事にはアフィリエイト広告を含む広告が掲載されており、その広告費によって運営しています。
Amazonのアソシエイトとして、ララテックは適格販売により収入を得ています。

Laravelのルーティングの基本的な書き方を、web.phpへの書き方・パラメータとwhere・route関数の引数・グループの順にまとめました。Laravel 13で、curlとroute:listの実際の出力で確かめています。

はじめに

Laravel 7 以前は、こちらの記事を参照してください。

→ Laravel6 のルーティングの書き方。覚える基本系の1つを厳選

それ以降のバージョンは、当記事と同じです。

2026年11月に、Docker の php:8.4-cli(PHP 8.4.27)・Laravel 13.42.0 で、この記事のルーティングを書いて動きを確かめ直しました。

確かめた結果は、各節の「Laravel 13 で確かめた結果」に書いています。

ルーティングを書く場所

routes/web.php

routes/api.php

などに書きます。

※ 2026-11-11 訂正: 以前は /route/web.php と書いていましたが、フォルダ名は routes です。

Laravel 13 で新しく作ったプロジェクトでは、routes フォルダにあるのは次の2つだけでした。

console.php
web.php

api.php は最初はありません!

php artisan install:api を実行すると、routes/api.php が作られます。

   INFO  API scaffolding installed. Please add the [Laravel\Sanctum\HasApiTokens] trait to your User model.

bootstrap/app.php に api: の行が足され、api.php に書いたルートには api/ が先頭に付きます。

  GET|HEAD       api/user ................................... routes/api.php:6

ルーティングの基本的な書き方

すべて書いてしまうパターン(非推奨)

Route::get('/user', function (Request $request) {
    return $request->user();
})->middleware('auth:sanctum');

この書き方だとルーティングが増えたり、API の処理が複雑な際に、読みづらくなります。

ルーティングではリクエストをコントローラーへ処理を渡すように書きましょう。

ちなみにこのコードは、install:api で作られる routes/api.php の中身そのままです。

Laravel 13 で、ログインせずに Accept: application/json を付けて /api/user へアクセスすると、401 が返りました。

ミニマムな書き方

use App\Http\Controllers\UserController;

Route::get('/user', [UserController::class, 'index']);

コントローラーは php artisan make:controller UserController で作れます。

name をつける方法

Route::get('/posts', [PostController::class, 'index'])->name('post.index'); //nameをつける

name を付けると、名付けたものを route()というヘルパ関数から使えるようになります。

route('post.index')

使用例:

<a href="{{ route('post.index') }}">ポスト一覧</a>
return redirect()->route('post.index');

※ 2026-11-11 訂正: 以前の使用例は href の値に " がありませんでした。

name を付けるメリットは、URL の変更をする際に、ルーティングを変更するだけで良いということです。

Laravel 13 で確かめた結果(route 関数の出力)

.env の APP_URL が http://localhost:8000 のとき、route() は次の URL を返しました。

route('post.index');                    // http://localhost:8000/posts
route('post.index', absolute: false);   // /posts

付けていない名前を指定するとエラーになります。

Symfony\Component\Routing\Exception\RouteNotFoundException
Route [post.show] not defined.

パラメーターを付ける方法

Route::get('/user/{id}', [UserController::class, 'show'])->name('user.show');

{id}このように波括弧で挟むことでパラメーターが入る前提のルーティングとなります。

また、パラメーターの条件を書くこともできます。

以下の例は、id は数字だけ入る時の書き方です。

Route::get('/user/{id}', [UserController::class, 'show'])->name('user.show')->where('id', '[0-9]+');

Laravel 13 で確かめた結果(where の条件)

上の where('id', '[0-9]+') 付きのルートに curl でアクセスしました。

/user/1                200 user show: 1
/user/abc              404

数字以外は、コントローラーまで届かずに 404 になります。

同じ条件は whereNumber('id') でも書けて、こちらも /item/12 は 200、/item/abc は 404 でした。

Route::get('/item/{id}', function (string $id) {
    return 'item: ' . $id;
})->whereNumber('id');

省略できるパラメーター

{name?} のように ? を付けると、パラメーターなしでも同じルートに入ります。

引数には既定値を書いておきます。

Route::get('/tag/{name?}', function (?string $name = 'all') {
    return 'tag: ' . $name;
});
/tag                   200 tag: all
/tag/php               200 tag: php

コントローラーでパラメーターを使うとき

引数に変数を書けば、何を書いても動きますが、ルーティングに書いたものを書くのが無難です。

public function show($id) //引数に書く。
{
  dd($id); //パラメーターが使える
  $user = User::find($id);
}

blade ファイルでリンクを書く時

<a href="{{ route('user.show', ['id' => 1]) }}">プロフィールを見る</a>

Laravel 13 で、route 関数の引数をいくつか変えて出力を見ました。

route('user.show', ['id' => 1]);                  // http://localhost:8000/user/1
route('user.show', 1);                            // http://localhost:8000/user/1
route('user.show', ['id' => 1, 'tab' => 'likes']); // http://localhost:8000/user/1?tab=likes

パラメーターが1つなら、配列にせず値だけ渡しても同じ URL になりました。

ルートにないキー(ここでは tab)は、クエリ文字列として後ろに付きます。

パラメーターを渡し忘れると、次のエラーになります。

Illuminate\Routing\Exceptions\UrlGenerationException
Missing required parameter for [Route: user.show] [URI: user/{id}] [Missing parameter: id].

暗黙の結合

ようするに、パラメーターの ID と、Model の ID を照合して自動的にモデルインスタンスを取得してくれる仕組みがあります。

ルーティング側に書くパラメーターは何でも動きますが、モデル名と関連したパラメータにしておくのが無難です。

Route::get('/user/{user}', [UserController::class, 'show'])->name('user.show')->where('user', '[0-9]+');
public function show(User $user) //UserモデルのパラメータのIDと一致するUserモデルインスタンスを取得
{
  dd($user); //`/user/1だと`IDが1のユーザー情報が取得されている。
}

これを知っておくと認可の時に役立ちます。

Laravel 13 では、上の /user/{id} と並べて試すため、URL を /member/{user} にして確かめました。

Route::get('/member/{user}', [UserController::class, 'showModel'])->name('member.show');
public function showModel(User $user)
{
    return 'user model: ' . $user->id . ' ' . $user->name;
}

ID が1のユーザー(名前は Taro)だけを登録した状態です。

/member/1              200 user model: 1 Taro
/member/999            404

存在しない ID は、コントローラーで find() の結果を調べなくても 404 になりました!

グルーピングする方法

ルーティングには、同じようなことを何度も書くことがあります。

例えば、認証ユーザーのみ使えるルーティング、非認証ユーザーのみ使えるルーティングなどがあります。

//認証ユーザーのみ
Route::middleware('auth:sanctum')->group(function () {
    Route::get('user/{id}', [UserController::class,'show']);
});

このグループは、

  1. ミドルウェア
  2. コントローラ
  3. サブドメインルーティング
  4. ルートプレフィックス
  5. ルート名のプレフィックス

5つの軸でグルーピングすることが可能です。

そして、併用することが可能です。

Route::middleware('auth:sanctum')->group(function () {
    Route::prefix('user')->group(function () {
      Route::get('/{id}', [UserController::class,'show']);
    });
});

コントローラ・プレフィックス・ルート名のプレフィックスを併用すると、次のように書けます。

Route::controller(PostController::class)->prefix('admin/posts')->name('admin.posts.')->group(function () {
    Route::get('/', 'index')->name('index');
    Route::get('/{id}', 'show')->name('show');
});

Laravel 13 の php artisan route:list では、URL に admin/posts が、名前に admin.posts. が付いていました。

  GET|HEAD   admin/posts ............ admin.posts.index › PostController@index
  GET|HEAD   admin/posts/{id} ......... admin.posts.show › PostController@show

route('admin.posts.show', 3) は http://localhost:8000/admin/posts/3 を返しました。

メリット

しっかりと方針を立てて何をグルーピングするか決めることで格段にルーティングがみやすくなります。

Route::middleware('auth:sanctum')->group(function () {
    Route::prefix('post')->group(function () {
      Route::get('/', [PostController::class,'index']);
      Route::get('/{id}', [PostController::class,'show']);
      Route::post('/', [PostController::class,'store']);
      Route::patch('/{id}', [PostController::class,'update']);
      Route::delete('/{id}', [PostController::class,'destroy']);
    });
});

全く同じ処理ですが、グルーピングを使わない場合以下のようになります。

Route::prefix('post')->get('/', [PostController::class,'index'])->middleware('auth:sanctum');
Route::prefix('post')->get('/{id}', [PostController::class,'show'])->middleware('auth:sanctum');
Route::prefix('post')->post('/', [PostController::class,'store'])->middleware('auth:sanctum');
Route::prefix('post')->patch('/{id}', [PostController::class,'update'])->middleware('auth:sanctum');
Route::prefix('post')->delete('/{id}', [PostController::class,'destroy'])->middleware('auth:sanctum');

※ 2026-11-11 訂正: 以前は destroy を destory と書いていました。

グルーピングした方が見やすいパターンもあるし、見辛くすることもあるので方針作りが大切だとは思います。

Laravel 13 で確かめた結果(グループと route:list)

Sanctum を入れる前に試したので、ミドルウェアを auth:sanctum ではなく auth にして、上のグループを書きました。

php artisan route:list では、5つのルートに post が付いていました。

  GET|HEAD   post ....................................... PostController@index
  POST       post ....................................... PostController@store
  GET|HEAD   post/{id} ................................... PostController@show
  PATCH      post/{id} ................................. PostController@update
  DELETE     post/{id} ................................ PostController@destroy

グループを使わない Route::prefix('article')->get(...) の書き方でも、article・article/{id} のルートができました。

ルートが増えたときは、--path や --name で絞り込めます。

php artisan route:list --name=user

  GET|HEAD       user/{id} ................... user.show › UserController@show

                                                            Showing [1] routes

auth ミドルウェアで 500 エラーになったとき

ログインしていない状態で /post を開くと、ログイン画面へ移るのではなく 500 エラーになりました。

storage/logs/laravel.log には次のように出ていました。

local.ERROR: Route [login] not defined.

auth ミドルウェアは、ログインしていない人を login という名前のルートへ送ろうとします。

新しいプロジェクトにはそのルートがないので、エラーになります。

login という名前のルートを足すと、302 で /login へ移るようになりました。

Route::get('/login', function () {
    return 'login page';
})->name('login');
/post 302 http://localhost:8000/login

Accept: application/json を付けたリクエストでは、ルートを足す前から 401 と {"message":"Unauthenticated."} が返りました。

まとめ

色々な書き方ありますが、よく使うものだけピックアップしました。

書いたルートは php artisan route:list で一覧にできるので、URL や名前が思った通りになっているかを確かめながら書くのがおすすめです!

route:cache をしたあとに足したルートが出てこないときは、Laravelのキャッシュクリアのコマンド一覧 の route:clear を見てください。

すべて知りたいという方は、以下のサイトに書いてありますので見てみてください。

Laravel 13.x Routing(公式ドキュメント)

Laravel 11.x ルーティング

フィードバックのお願い
この記事のフィードバックがありましたらYoutubeの適当な動画にコメントしていただいたり、お問い合わせからご連絡ください。