Laravel的路由系统负责将客户端的HTTP请求映射到对应的处理逻辑,所有路由定义默认都存放在routes目录下的对应文件中,其中web.php用于处理网页访问相关的请求,api.php用于处理接口相关的请求,合理的路由配置能够让项目的请求处理逻辑更清晰,也便于后续的维护与扩展。

基础路由定义方法
最基础的路由可以直接在路由文件中定义,指定请求方法、路由路径以及对应的处理逻辑,处理逻辑可以是闭包函数,也可以指向控制器中的方法。常见的HTTP请求方法都支持单独定义,也可以通过match或any方法适配多种请求。
<?php
// 定义GET请求的路由,访问 /hello 时返回字符串
Route::get('/hello', function () {
return '欢迎访问Laravel路由示例';
});
// 定义POST请求的路由,用于处理表单提交
Route::post('/submit-form', function () {
return '表单提交成功';
});
// 同时支持GET和POST请求的路由
Route::match(['get', 'post'], '/test', function () {
return '支持多种请求方式的路由';
});
// 支持所有HTTP请求方法的路由,谨慎使用
Route::any('/all-request', function () {
return '适配所有请求方式的路由';
});带参数的路由定义
实际业务中经常需要传递参数给路由,比如获取指定ID的用户信息,Laravel支持定义必选参数和可选参数,也支持对参数添加正则约束,避免不符合规则的请求进入处理逻辑。
<?php
// 必选路由参数,{id}是参数占位符
Route::get('/user/{id}', function ($id) {
return '用户ID为:' . $id;
});
// 可选路由参数,参数后加?,同时需要给默认值
Route::get('/post/{slug?}', function ($slug = 'default') {
return '文章标识为:' . $slug;
});
// 对参数添加正则约束,限制id只能是数字
Route::get('/article/{id}', function ($id) {
return '文章ID为:' . $id;
})->where('id', '[0-9]+');
// 多个参数同时添加约束
Route::get('/user/{id}/post/{post_id}', function ($id, $post_id) {
return '用户' . $id . '的文章' . $post_id;
})->where(['id' => '[0-9]+', 'post_id' => '[0-9]+']);路由与控制器绑定
当路由的处理逻辑比较复杂时,不建议直接写在闭包中,而是绑定到对应的控制器方法,这样能够让路由文件更简洁,也符合MVC的开发规范。首先需要创建对应的控制器,再在路由中指定控制器和方法。
<?php
// 单动作控制器绑定,指向UserController的index方法
Route::get('/users', 'UserController@index');
// 带参数的控制器路由,参数会自动传递给控制器方法
Route::get('/user/detail/{id}', 'UserController@detail');
// 使用action方法指定控制器,避免字符串拼接
Route::get('/goods/list', 'App\Http\Controllers\GoodsController@list');路由分组与中间件
当多个路由有共同的配置时,比如都需要登录校验、都属于同一个前缀路径,可以使用路由分组来简化配置,减少重复代码。中间件可以在请求进入处理逻辑前执行校验逻辑,比如权限判断、登录状态校验等。
<?php
// 路由分组,统一添加/auth前缀,绑定auth中间件校验登录
Route::middleware(['auth'])->prefix('auth')->group(function () {
// 访问 /auth/profile 需要先登录
Route::get('/profile', 'UserController@profile');
// 访问 /auth/settings 需要先登录
Route::get('/settings', 'UserController@settings');
});
// 给路由单独绑定中间件
Route::get('/admin/dashboard', 'AdminController@dashboard')->middleware('admin');路由命名与生成
给路由定义名称可以方便后续在代码中生成对应的URL,避免硬编码路由路径,当路由路径需要修改时,只需要修改路由定义,不需要全局替换所有使用路径的地方。
<?php
// 定义带名称的路由,使用name方法
Route::get('/login', 'AuthController@login')->name('login');
// 在代码中生成该路由的URL
$loginUrl = route('login');
// 带参数的路由生成URL
Route::get('/user/{id}', 'UserController@detail')->name('user.detail');
$userUrl = route('user.detail', ['id' => 10]);常用路由配置注意事项
- 路由定义的顺序需要注意,更具体的路由要放在通用路由前面,避免被提前匹配
- 接口路由建议放在api.php中,会自动添加api前缀,也支持单独的中间件配置
- 生产环境可以缓存路由配置,提升路由匹配的效率,缓存后修改路由需要重新缓存
- 不要在路由闭包中写复杂的业务逻辑,尽量将逻辑放到控制器或服务层中