Laravel 中的路由,跟其他 PHP 框架一样,作用是把各种请求分流到各个控制器。
最简单的路由由一个 URI 和一个闭包调用组成。
路由文件在:`learnlaravel5/app/Http/routes.php` :
基本 GET 路由
1
2
3
4
|
Route::
get
(
'/'
, function()
{
return
'Hello World'
;
});
|
基本 POST 路由
1
2
3
4
|
Route::post(
'foo/bar'
, function()
{
return
'Hello World'
;
});
|
注册一个路由以响应所有 HTTP 方法
1
2
3
4
|
Route::any(
'foo'
, function()
{
return
'Hello World'
;
});
|
强制一个路由必须通过 HTTPS 访问
1
2
3
4
|
Route::
get
(
'foo'
, array(
'https'
, function()
{
return
'Must be over HTTPS'
;
}));
|
路由参数
1
2
3
4
|
Route::
get
(
'user/{id}'
, function($id)
{
return
'User '
.$id;
});
|
可选的路由参数
1
2
3
4
|
Route::
get
(
'user/{name?}'
, function($name =
null
)
{
return
$name;
});
|
带默认值的可选的路由参数
1
2
3
4
|
Route::
get
(
'user/{name?}'
, function($name =
'John'
)
{
return
$name;
});
|
带正则表达式约束的路由
1
2
3
4
5
6
7
8
9
10
|
Route::
get
(
'user/{name}'
, function($name)
{
//
})
->
where
(
'name'
,
'[A-Za-z]+'
);
Route::
get
(
'user/{id}'
, function($id)
{
//
})
->
where
(
'id'
,
'[0-9]+'
);
|
路由过滤器
路由过滤器提供了一种限制访问指定路由的简单的方法,这在您需要为您的站点创建需要认证区域的时候非常有用。Laravel 框架中包含了一些路由过滤器,比如 auth 过滤器、auth.basic 过滤器、guest 过滤器、以及 csrf 过滤器。它们被存放在 app/filters.php 文件中。
定义一个路由过滤器
1
2
3
4
5
6
7
|
Route::filter(
'old'
, function()
{
if
(Input::
get
(
'age'
) < 200)
{
return
Redirect::to(
'home'
);
}
});
|
如果一个响应从一个路由过滤器中返回,这个响应即被认为是这个请求的响应,路由将不被执行,任何关于这个路由的 after 过滤器也将被取消执行。
为一个路由指定一个路由过滤器
1
2
3
4
|
Route::
get
(
'user'
, array(
'before'
=>
'old'
, function()
{
return
'You are over 200 years old!'
;
}<br data-filtered=
"filtered"
>));
|
为一个路由指定多个路由过滤器
1
2
3
4
|
Route::
get
(
'user'
, array(
'before'
=>
'auth|old'
, function()
{
return
'You are authenticated and over 200 years old!'
;
}<br data-filtered=
"filtered"
>));
|
指定路由过滤器参数
1
2
3
4
5
6
7
8
|
Route::filter(
'age'
, function($route, $request, $value)
{
//
});
Route::
get
(
'user'
, array(
'before'
=>
'age:200'
, function()
{
return
'Hello World'
;
}));
|
当路由过滤器接收到作为第三个参数的响应 $response:
1
2
3
4
|
Route::filter(
'log'
, function($route, $request, $response, $value)
{
//
});
|
基本路由过滤器的模式
您可能希望根据 URI 为一组路由指定过滤器。
1
2
3
4
5
|
Route::filter(
'admin'
, function()
{
//
});
Route::when(
'admin/*'
,
'admin'
);
|
在上面的例子中,admin 过滤器将应用带有所有以 admin/ 开头的路由。星号作为一个通配符,将适配到所有字符的组合。
您也可以通过指定 HTTP 方法约束模式过滤器:
1
|
Route::when(
'admin/*'
,
'admin'
, array(
'post'
));
|
使用过滤器类
对于高级的过滤器,您可以使用一个类代替闭包函数。因为过滤器类是位于应用程序之外的 IoC 容器,您能够在过滤器中使用依赖注入,更易于测试。
定义一个过滤器类
1
2
3
4
5
6
|
class
FooFilter {
public
function filter()
{
// Filter logic...
}
}
|
注册一个基于类的过滤器
1
|
Route::filter(
'foo'
,
'FooFilter'
);
|
命名路由
命名路由在更易于在生成跳转或 URLs 时指定路由。您可以像这样为路由指定一个名字:
1
2
3
4
|
Route::
get
(
'user/profile'
, array(
'as'
=>
'profile'
, function()
{
//
}));
|
也可以为控制器的方法指定路由名字:
1
2
|
Route::
get
(
'user/profile'
, array(
'as'
=>
'profile'
,
'uses'
=>
'UserController@showProfile'
));
|
现在生成 URLs 或跳转的时候使用路由的名字:
1
2
|
$url = URL::route(
'profile'
);
$redirect = Redirect::route(
'profile'
);
|
使用 currentRouteName 方法获取一个路由的名字:
1
|
$name = Route::currentRouteName();
|
路由组
有些时候您可能希望应用过滤器到一组路由。您不必要为每个路由指定过滤器,可以使用路由组:
1
2
3
4
5
6
7
8
9
10
11
|
Route::
group
(array(
'before'
=>
'auth'
), function()
{
Route::
get
(
'/'
, function()
{
// Has Auth Filter
});
Route::
get
(
'user/profile'
, function()
{
// Has Auth Filter
});
});
|
子域名路由
Laravel 路由也能够处理通配符的子域名,并且从域名中获取通配符参数:
注册子域名路由
1
2
3
4
5
6
7
|
Route::
group
(array(
'domain'
=>
'{account}.myapp.com'
), function()
{
Route::
get
(
'user/{id}'
, function($account, $id)
{
//
});
});
|
路由前缀
一组路由可以通过在属性数组中使用 prefix 选项为路由组添加前缀:
为路由组添加前缀
1
2
3
4
5
6
7
|
Route::
group
(array(
'prefix'
=>
'admin'
), function()
{
Route::
get
(
'user'
, function()
{
//
});
});
|
路由模型绑定
模型绑定提供了一个简单的方法向路由中注入模型。比如,不仅注入一个用户的 ID,您可以根据指定的 ID 注入整个用户模型实例。首先使用 Route::model 方法指定所需要的模型:
为模型绑定一个变量
1
|
Route::model(
'user'
,
'User'
);
|
然后, 定义一个包含 {user} 参数的路由:
1
2
3
4
|
Route::
get
(
'profile/{user}'
, function(User $user)
{
//
});
|
因为我们已经绑定 {user} 参数到 User 模型,一个 User 实例将被注入到路由中。因此,比如一个 profile/1 的请求将注入一个 ID 为 1 的 User 实例。
注意: 如果在数据库中没有找到这个模型实例,将引发404错误。
如果您希望指定您自己定义的没有找到的行为,您可以为 model 方法传递一个闭包作为第三个参数:
1
2
3
4
|
Route::model(
'user'
,
'User'
, function()
{
throw
new
NotFoundException;
});
|
用自己的方法处理路由参数,可以使用 Route::bind 方法:
1
2
3
4
|
Route::bind(
'user'
, function($value, $route)
{
return
User::
where
(
'name'
, $value)->first();
});
|
引发404错误
有两种方法在路由中手动触发一个404错误。首先,您可以使用 App::abort 方法:
1
|
App::abort(404);
|
控制器路由
每条地址规则都要定义路由,岂不是很累?
laravel给了我们一个折中的方案——控制器路由:
1
|
Route::controller(
'/'
,
'HomeController'
);
|
控制器方法的写法也要有所变化:
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
|
<?php
namespace
App\Http\Controllers;
use App\Http\Controllers\Controller;
class
HomeController extends Controller {
/**
* 显示首页。
*
* @return Response
*/
public
function getIndex()
{
return
view(
'home'
);
}
/**
* 显示关于界面
*
* @return Response
*/
public
function getAbout()
{
return
view(
'about'
);
}
}
|
依照上述例子,
如果我们访问地址http://yourdomain/
就会显示HomeController
的getIndex
方法产生的内容,
访问http://yourdomain/about
,就会显示getAbout
方法产生的内容。
除了使用如get{Method}
这种格式,还可以有post{Method}
、delete{Method}
等,至于前缀get
,post
等代表的意义,你懂得!
资源控制器
资源控制器和RESTful有着莫大的联系,要理解资源控制器,必须先了解RESTful。不懂自己百度!
Laravel的资源控制器原生的支持了RESTful架构。其实laravel的资源控制器和其他控制器没什么直接区别,只是对控制器类的方法和结构略有规定。
要在路由里定义一个资源控制器只需要一条:
1
|
Route::resource(
'article'
,
'ArticleController'
);
|
访问的地址规则:
请求方法 | 请求URI | 对应的控制器方法 | 代表的意义 |
---|---|---|---|
GET | /article | index | 索引/列表 |
GET | /article/create | create | 创建(显示表单) |
POST | /article | store | 保存你创建的数据 |
GET | /article/{id} | show | 显示对应id的内容 |
GET | /article/{id}/edit | edit | 编辑(显示表单) |
PUT/PATCH | /article/{id} | save | 保存你编辑的数据 |
GET | /article/{id} | destroy | 删除 |
挑两条解释。
我定义了个资源路由Route::resource('article', 'ArticleController');
。
当我访问地址http://yourdomain/article
,相当于访问控制器ArticleController
的index
方法。
当我访问地址http://yourdomain/article/create
,就会访问到create
方法。
当我通过POST提交数据至地址http://yourdomain/article
,相当于由store
方法处理。
--------------------扩展------------------------------
根据路由产生 URLs,您可以通过使用 URL::to 方法:
1
|
$url = URL::to(
'foo'
);
|