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

前缀分组

CreateWise AI
CreateWise AI

为播客创作者设计的AI创作工具,AI自动去口癖、提交亮点和生成Show notes、标题等

下载
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 应用的访问路径。不复杂但容易忽略的是约束规则和命名规范,合理使用能让项目更清晰。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

340

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

293

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

773

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

385

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

141

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

85

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

80

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

574

2026.03.04

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

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

精品课程

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

共137课时 | 13.5万人学习

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

共6课时 | 11.3万人学习

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

共13课时 | 1.0万人学习

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

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