Laravelのルーティングの書き方(web.php・パラメータ・route関数・グループ)
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.phpapi.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']);
});このグループは、
- ミドルウェア
- コントローラ
- サブドメインルーティング
- ルートプレフィックス
- ルート名のプレフィックス
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@showroute('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] routesauth ミドルウェアで 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/loginAccept: application/json を付けたリクエストでは、ルートを足す前から 401 と {"message":"Unauthenticated."} が返りました。
まとめ
色々な書き方ありますが、よく使うものだけピックアップしました。
書いたルートは php artisan route:list で一覧にできるので、URL や名前が思った通りになっているかを確かめながら書くのがおすすめです!
route:cache をしたあとに足したルートが出てこないときは、Laravelのキャッシュクリアのコマンド一覧 の route:clear を見てください。
すべて知りたいという方は、以下のサイトに書いてありますので見てみてください。




