路由系统：从 URL 到控制器

这一课你将能做到

1. 写出带参数、约束、命名的路由，并能用 route() 反向生成 URL
2. 用路由分组统一配置前缀、中间件、子域名和控制器命名空间
3. 使用路由模型绑定直接拿到模型实例，并用 route:list 排查路由问题

为什么要学

路由是 URL 与代码之间的契约。Spring Boot 里你用 @GetMapping("/orders/{id}") 把 URL 绑到方法上，Laravel 的路由文件承担完全相同的职责，但表达能力更集中：参数约束、默认值、命名、分组、模型绑定、限流、限流退避都可以在一行链式调用里声明。

真实后端项目里路由还承载两个工程问题：接口版本化（/api/v1/...）和权限分层（游客、登录用户、管理员）。掌握分组和中间件组合后，这两件事都能用统一结构表达，而不用在每个控制器方法里重复写判断。

先建立图像

请求  GET /api/v1/orders/42
                 │
                 ▼
        routes/api.php
                 │
  Route::prefix('v1')->middleware('auth:sanctum')->group(...)
                 │
        Route::get('/orders/{order}', ...)
                 │         │
                 │         └─ 路由模型绑定：{order} → Order 模型（id=42）
                 ▼
        [OrderController::class, 'show']

与 Spring Boot 对照：

Laravel	Spring Boot
Route::get('/orders/{order}', ...)	@GetMapping("/orders/{order}")
{order} 参数 + whereNumber()	@PathVariable Long order + 正则/校验
->name('orders.show')	没有内建等价物（手写路径常量）
Route::middleware(['auth'])	@PreAuthorize 或过滤器
路由模型绑定	需在方法内 orderRepository.findById()
php artisan route:list	Actuator mappings（需额外开启）

跟着做

步骤 1：基础动词路由

在 routes/api.php 中写一组资源路由：

<?php

use App\Http\Controllers\Api\OrderController;
use Illuminate\Support\Facades\Route;

Route::get('/ping', fn () => response()->json(['pong' => true]));

// 单个动词
Route::get('/orders', [OrderController::class, 'index']);
Route::post('/orders', [OrderController::class, 'store']);
Route::get('/orders/{order}', [OrderController::class, 'show']);
Route::match(['put', 'patch'], '/orders/{order}', [OrderController::class, 'update']);
Route::delete('/orders/{order}', [OrderController::class, 'destroy']);

// 等价的资源路由一行声明（7 个 RESTful 动作）
Route::apiResource('orders', OrderController::class);