Laravel路由配置位于routes目录,web.php处理Web请求,api.php用于API接口。通过Route门面定义GET、POST等请求路由,支持闭包和控制器方法。可使用{param}定义必填或{param?}可选参数,并用where添加正则约束。命名路由便于生成URL和重定向,如name('user.show')配合route()函数。路由分组可统一设置中间件、前缀、命名空间和名称前缀,提升组织性。推荐使用控制器替代闭包,Resource路由自动生成RESTful动作。Fallback路由处理未匹配请求,生产环境可用php artisan route:cache提升性能,但闭包路由不支持缓存。

在 Laravel 中,路由是应用的核心组成部分之一,它负责将用户的请求映射到相应的控制器或闭包函数。Laravel 提供了灵活且强大的路由系统,支持多种 HTTP 请求方式、参数传递、中间件绑定和命名路由等功能。下面详细介绍 Laravel 路由的配置方法与常见用法。
Laravel 的路由定义主要位于 routes 目录下,常见的文件包括:
web 中间件组(如会话、CSRF 保护)。api 中间件组(无状态、基于 token 验证)。大多数情况下,你只需要操作 web.php 和 api.php。
Laravel 支持为不同的 HTTP 方法注册路由:
示例:
use Illuminate\Support\Facades\Route;
// 响应 GET 请求
Route::get('/home', function () {
return 'Hello, Laravel!';
});
// 响应 POST 请求
Route::post('/submit', function () {
return 'Data submitted';
});
// 同时响应多个方法
Route::match(['get', 'post'], '/form', function () {
return 'Form page';
});
// 响应任意方法
Route::any('/any', function () {
return 'Any method accepted';
});
有时需要从 URL 中获取动态参数,Laravel 支持必填和可选参数。
必填参数:
Route::get('/user/{id}', function ($id) {
return "User ID: $id";
});
可选参数(使用 ? 定义,默认值可设置):
Route::get('/user/{name?}', function ($name = 'Guest') {
return "Hello, $name";
});
参数约束:通过正则表达式限制参数格式:
Route::get('/user/{id}', function ($id) {
return "User: $id";
})->where('id', '[0-9]+'); // 只允许数字
// 多个参数约束
Route::get('/user/{id}/{name}', function ($id, $name) {
//
})->where(['id' => '[0-9]+', 'name' => '[a-zA-Z]+']);
为路由起名字,便于在模板或代码中生成 URL 或重定向。
Route::get('/dashboard', function () {
return view('dashboard');
})->name('dashboard');
// 在视图中使用 route() 辅助函数
// route('dashboard') → /dashboard
// 重定向
return redirect()->route('dashboard');
带参数的命名路由:
Route::get('/user/{id}', function ($id) {
return "User $id";
})->name('user.show');
// 生成 URL:route('user.show', ['id' => 1]) → /user/1
使用分组可以为一组路由统一设置中间件、前缀、命名空间或名称前缀。
中间件分组:
Route::middleware(['auth'])->group(function () {
Route::get('/profile', function () {
return 'Profile page';
});
});
前缀分组:
Route::prefix('admin')->group(function () {
Route::get('/users', function () {
return 'Admin Users List';
});
// 最终路径:/admin/users
});
命名空间(适用于控制器):
Route::namespace('Admin')->prefix('admin')->group(function () {
Route::get('/dashboard', 'DashboardController@index');
});
名称前缀:
Route::name('admin.')->group(function () {
Route::get('/users', function () {
// 路由名为 admin.users
})->name('users');
});
推荐将逻辑放在控制器中,而不是闭包函数里。
// 定义控制器路由
Route::get('/posts', 'PostController@index');
Route::post('/posts', 'PostController@store');
使用 Route::resource() 快速生成 RESTful 资源路由:
Route::resource('posts', 'PostController');
这会自动生成 index、create、store、show、edit、update、destroy 七个动作对应的路由。
也可指定只生成部分方法:
Route::resource('posts', 'PostController')->only(['index', 'show']);
Route::resource('posts', 'PostController')->except(['destroy']);
当没有匹配到任何路由时,执行 fallback 路由:
Route::fallback(function () {
return '404 Not Found';
});
通常放在所有路由之后。
在生产环境中,可以通过 Artisan 命令缓存路由以提升性能:
php artisan route:cache
清除缓存:
php artisan route:clear
注意:闭包路由无法被缓存,因此建议全部使用控制器路由。
基本上就这些。掌握这些配置方法后,你可以高效地组织 Laravel 应用的访问路径。不复杂但容易忽略的是约束规则和命名规范,合理使用能让项目更清晰。
以上就是Laravel路由怎么配置_Laravel路由配置方法与常见用法解析的详细内容,更多请关注php中文网其它相关文章!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号