0

0

Laravel路由怎么配置_Laravel路由配置方法与常见用法解析

蓮花仙者

蓮花仙者

发布时间:2025-11-25 21:16:57

|

754人浏览过

|

来源于php中文网

原创

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路由配置方法与常见用法解析

在 Laravel 中,路由是应用的核心组成部分之一,它负责将用户的请求映射到相应的控制器或闭包函数。Laravel 提供了灵活且强大的路由系统,支持多种 HTTP 请求方式、参数传递、中间件绑定和命名路由等功能。下面详细介绍 Laravel 路由的配置方法与常见用法。

1. 路由文件位置

Laravel 的路由定义主要位于 routes 目录下,常见的文件包括:

  • web.php:用于定义 Web 界面路由,自动应用 web 中间件组(如会话、CSRF 保护)。
  • api.php:用于定义 API 接口路由,自动应用 api 中间件组(无状态、基于 token 验证)。
  • console.php:定义 Artisan 命令相关的路由。
  • channels.php:定义广播事件的授权频道。

大多数情况下,你只需要操作 web.phpapi.php

2. 基本路由定义

Laravel 支持为不同的 HTTP 方法注册路由:

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

示例:

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';
});

3. 路由参数

有时需要从 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]+']);

4. 路由命名与生成 URL

为路由起名字,便于在模板或代码中生成 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

5. 路由分组

使用分组可以为一组路由统一设置中间件、前缀、命名空间或名称前缀。

中间件分组

Route::middleware(['auth'])->group(function () {
    Route::get('/profile', function () {
        return 'Profile page';
    });
});

前缀分组

Quillbot
Quillbot

一款AI写作润色工具,QuillBot的人工智能改写工具将提高你的写作能力。

下载
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');
});

6. 控制器路由

推荐将逻辑放在控制器中,而不是闭包函数里。

// 定义控制器路由
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']);

7. Fallback 路由

当没有匹配到任何路由时,执行 fallback 路由:

Route::fallback(function () {
    return '404 Not Found';
});

通常放在所有路由之后。

8. 路由缓存

在生产环境中,可以通过 Artisan 命令缓存路由以提升性能:

php artisan route:cache

清除缓存:

php artisan route:clear

注意:闭包路由无法被缓存,因此建议全部使用控制器路由。

基本上就这些。掌握这些配置方法后,你可以高效地组织 Laravel 应用的访问路径。不复杂但容易忽略的是约束规则和命名规范,合理使用能让项目更清晰。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2408

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1551

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1449

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

951

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1414

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1233

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1445

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1305

2023.11.13

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

97

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.5万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号