Laravel路由怎么配置_Laravel路由配置规则及常见用法实例讲解

Laravel路由配置位于routes目录，支持GET、POST等HTTP方法，可通过闭包或控制器处理请求。可定义必选、可选参数及正则约束，支持路由命名、分组（中间件、前缀、域名、命名空间）、资源路由生成CRUD接口，还可直接返回视图或设置重定向，适用于Web和API开发场景。

Laravel 的路由系统非常强大且灵活，它允许你将 URL 请求映射到对应的控制器或闭包函数。掌握路由配置是开发 Laravel 应用的基础。下面详细介绍 Laravel 路由的配置规则和常见用法。

路由文件位置

Laravel 的路由定义主要位于 routes 目录下，常见的文件有：

• web.php：处理 Web 页面请求（自动应用了 session、CSRF、cookie 等中间件）
• api.php：处理 API 请求（无状态，通常用于接口）
• console.php：命令行路由
• channels.php：广播频道授权

基本路由语法

最简单的路由使用 Route 门面来定义，支持常见的 HTTP 方法：

• GET：获取资源
• POST：提交数据
• PUT/PATCH：更新资源
• DELETE：删除资源

示例：

use Illuminate\Support\Facades\Route;
// 响应 GET 请求
Route::get('/hello', function () {
return 'Hello, Laravel!';
});
// 响应 POST 请求
Route::post('/submit', function () {
return '表单已提交';
});
// 同时支持多个方法
Route::match(['get', 'post'], '/form', function () {
return '支持 GET 和 POST';
});
// 支持所有方法
Route::any('/any', function () {
return '任何请求都可访问';
});

路由参数

你可以定义带参数的路由，用于动态匹配 URL。

必选参数：

Route::get('/user/{id}', function ($id) {
    return "用户ID: $id";
});
// 多个参数
Route::get('/user/{id}/post/{post}', function ($id, $post) {
return "用户 $id 的文章 $post";
});

可选参数：

Route::get('/user/{name?}', function ($name = '匿名') {
    return "用户名: $name";
});

参数约束（正则验证）：

Route::get('/user/{id}', function ($id) {
    return "用户ID: $id";
})->where('id', '[0-9]+'); // 只接受数字
// 多个约束
Route::get('/user/{id}/{name}', function ($id, $name) {
return "$id - $name";
})->where([
'id'   => '[0-9]+',
'name' => '[a-zA-Z]+'
]);

路由命名

给路由起名字，便于在模板或代码中生成 URL 或跳转。

Route::get('/profile', function () {
    return '个人中心';
})->name('profile');
// 在视图中使用：route('profile')
// 在控制器中重定向：return redirect()->route('profile');

带参数的命名路由：

Route::get('/user/{id}', function ($id) {
    return "用户 $id";
})->name('user.show');
// 生成链接：route('user.show', ['id' => 123])

路由分组

将具有相同属性的路由归类，提升管理效率。

中间件分组：

Route::middleware(['auth'])->group(function () {
    Route::get('/dashboard', function () {
        return '控制台';
    });
    Route::get('/settings', function () {
        return '设置页';
    });
});

前缀分组：

Route::prefix('admin')->group(function () {
    Route::get('/users', function () {
        return '管理员用户列表';
    }); // 访问 /admin/users
});

命名空间分组（控制器路由常用）：

Route::namespace('Admin')->group(function () {
    Route::get('/admin/profile', 'AdminController@profile');
});

域名分组：

Route::domain('{account}.example.com')->group(function () {
    Route::get('/user/{id}', function ($account, $id) {
        return "账户: $account, 用户: $id";
    });
});

路由指向控制器

实际项目中，路由通常指向控制器方法。

// 使用 Artisan 创建控制器
// php artisan make:controller UserController
use App\Http\Controllers\UserController;
Route::get('/users', [UserController::class, 'index']);
Route::get('/users/{id}', [UserController::class, 'show']);
Route::post('/users', [UserController::class, 'store']);

资源路由（RESTful）：

一键生成 CRUD 路由。

Route::resource('posts', PostController::class);
// 自动生成 index, create, store, show, edit, update, destroy

只注册部分资源路由：

Route::resource('photos', PhotoController::class)
     ->only(['index', 'show']);
Route::resource('photos', PhotoController::class)
->except(['destroy']);

视图路由（直接返回视图）

适合静态页面，无需写控制器。

Route::view('/about', 'about'); // 返回 resources/views/about.blade.php
Route::view('/welcome', 'welcome', ['name' => 'Laravel']);

重定向路由

快速重定向某个路径。

Route::redirect('/here', '/there'); // 302 临时重定向
Route::permanentRedirect('/old', '/new'); // 301 永久重定向

基本上就这些。掌握这些 Laravel 路由配置方法，就能应对大多数开发场景。