一、HTTP路由
所有路由都定义在 App\Providers\RouteServiceProvider 类载入的 app/Http/routes.php文件中。
1. 基本路由
简单的 Laravel 路由只接受一个 URI 和一个闭包
|
1
2
3
|
Route::get('foo', function () {
return 'Hello, Laravel!';
}); |
对于常见的 HTTP 请求,Laravel 有以下几种路由
|
1
2
3
4
5
6
7
8
9
|
Route::get($uri, $callback); //响应 get 请求
Route::post($uri, $callback);
Route::put($uri, $callback);
Route::patch($uri, $callback);
Route::delete($uri, $callback);
Route::options($uri, $callback);
Route::match(['get', 'post'], $uri, $callback); //响应 get, post 请求
Route::any('foo', $callback); //响应所有请求
|
其中,$callback 可以是一个闭包,也可以是一个控制器方法。实际上,在开发中有不少情况是用作控制器方法的。
2. 路由参数
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
|
//单个路由参数Route::get('user/{id}', function ($id) {
return 'User '.$id;
});//多个路由参数Route::get('posts/{post}/comments/{comment}', function ($postId, $commentId) {
//
});//单个路由参数(可选)Route::get('user/{id?}', function ($id = 1) {
return 'User '.$id;
});//多个路由参数(可选)Route::get('posts/{post}/comments/{comment?}', function ($postId, $commentId = 1) {
//
});//注意:多个参数时,只可以对最后一个参数设置可选,其他位置设置可选会解析错误// 正则约束单个参数Route::get('user/{name?}', function ($name = 'Jone') {
return $name;
})->where('name', '\w+'); //约束参数为单词字符(数字、字母、下划线)
// 正则约束多个参数Route::get('user/{id}/{name}', function ($id, $name) {
//
})->where(['id' => '[0-9]+', 'name' => '[a-z]+']);
|
二、创建控制器
使用 Artisan 命令创建 php artisan make:controller UserController
现在,在 app/Http/Controllers 这个控制器目录下就生成了 UserController.php 的控制器文件。
三、高级路由
1. 命名路由
|
1
2
3
4
5
6
7
8
9
|
//命名闭包路由Route:get('user', array('as' => 'alial', function(){});
//或 name 方法链Route:get('user', function(){})->name('alias');
//命名控制器方法路由//或 name 方法链 |
2. 路由分组
2.1 路由前缀和命名空间
例如,有两条指向控制器方法的路由
|
1
2
|
|
拿第一条来说,
参数一:admin/login 表示这个 URI 在请求网站根目录下的 admin/login 资源,完整地址就是 http://域名/admin/login (这里开启了 Apache 的路由重写,隐藏了 “index.php“ ),这个请求被映射到第二个参数中指定的控制器方法。注意,网站根目录是入口文件所在目录,在 Laravel 中就是 public 目录,配置服务器时最好也指向这里。
参数二:Admin\[email protected] 表示这个控制器方法是在 App\Http\Controllers 命名空间下的,连起来就是 App\Http\Controllers\Admin\IndexController 控制器里的 login 方法。
显然,两条路由的 URI 和 控制器方法 都有相同的部分,那么,启用路由分组可以提取出公共部分:
|
1
2
3
4
5
|
// 第一个数组参数中,prefix 键定义 URI 的公共部分,namespace 键定义方法名(命名空间语法)的公共部分Route::group(array('prefix' => 'admin', 'namespace' => 'Admin'), function(){
}); |
2.2 资源路由
资源路由就是映射到资源控制器的路由,Laravel 资源控制器内置了对资源增删改查的 7 个方法以及 7 条路由。
首先,创建资源控制器 ArticleController
|
1
|
php artisan make:controller Admin/ArticleController --resource |
这样就生成了资源控制器在 app/Http/Controllers/Admin/ArticleController.php 文件(Admin 文件夹不存在时会自动创建),内置的 7 个方法如下 :
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
|
<?phpnamespace App\Http\Controllers\Admin;
use Illuminate\Http\Request;
use App\Http\Requests;
use App\Http\Controllers\Controller;
class LinksController extends Controller
{ /**
* 显示一个资源的列表
*
* @return \Illuminate\Http\Response
*/
public function index()
{
//
}
/**
* 显示一个表单来创建一个新的资源
*
* @return \Illuminate\Http\Response
*/
public function create()
{
//
}
/**
* 保存最新创建的资源
*
* @param \Illuminate\Http\Request $request
* @return \Illuminate\Http\Response
*/
public function store(Request $request)
{
//
}
/**
* 显示指定的资源
*
* @param int $id
* @return \Illuminate\Http\Response
*/
public function show($id)
{
//
}
/**
* 显示一个表单来编辑指定的资源
*
* @param int $id
* @return \Illuminate\Http\Response
*/
public function edit($id)
{
//
}
/**
* 更新指定的资源
*
* @param \Illuminate\Http\Request $request
* @param int $id
* @return \Illuminate\Http\Response
*/
public function update(Request $request, $id)
{
//
}
/**
* 删除指定的资源
*
* @param int $id
* @return \Illuminate\Http\Response
*/
public function destroy($id)
{
//
}
} |
然后,定义资源路由 。这里我还是选择在路由分组下定义,定义一条就好
|
1
2
3
4
5
6
|
Route::group(array('prefix' => 'admin', 'namespace' => 'Admin'), function(){
// 资源路由
Route::resource('article', 'ArticleController');
}); |
最后,查看路由。有了资源控制器 和 资源路由,就可以看一下对以上 7 个方法的 HTTP 请求方式了。
使用 Artisan 命令 php artisan route:list 列出当前的所有路由,请求方式、URI、控制器方法、中间件都罗列出来了。