Laravel HTTP 路由

路由配置文件

定义：路由是指分析来自客户端请求的统一资源标识符（URI），根据设定的规则将请求分发至期待的处理逻辑（匹配请求地址），这一规则就是路由规则，而这一过程就是路由。

Route::get(‘/’, function() {

return view(‘index’);

});

我们访问 http://yourdoamin/ 会显示渲染后的视图文件 index 的内容。这对于***一个网站首页而言，十分简明，不需要再额外创建控制器。当然，如果首页是一类组织方法中的一部分，也可以用控制器实现。

直接访问静态页面：

Route::get(‘about’, function() {

return view(‘about’);

});

通过地址 http://yourdomain/about 访问到关于页面，该页面在视图 about 文件内定义的。

路由配置文件位置：app/Http/routes.php 。大多数基本的 Laravel 路由都只接受一个 URI 和 一个 （闭包(Closure)，匿名函数？） 参数

如 闭包(一般很少用吧)：

//访问网站根目录就回输出 hello world

Route::get(‘/’, function(){

return ‘Hello World’;

});

基本get 例子：

//指定 get 方式访问 http://域名.com/test ，该路由将指向 /app/Http/Controllers 下面的 TestController 控制器的 index 方法。

Route::get(‘/test’, ‘TestController@index’);

//如果项目庞大，通常都会对控制器分组（仅需在 /app/Http/Controllers 目录下新建分组目录即可）。如：/app/Http/Controllers/shop

Route::get(‘/shop’, ‘shop/TestController@index’);

路由访问方式

可以指定路由的访问方式： get 、 post 、 put 、 delete 。指定了访问方式，使用其他方式访问将会报错。

Route::get(‘/’, function(){

return ‘Hello World’;

});

Route::post(‘/’, function(){

return ‘Hello World’;

});

Route::put(‘/’, function(){

return ‘Hello World’;

});

Route::delete(‘/’, function(){

return ‘Hello World’;

});

也可以指定多种访问方式

如下：将允许 get或者post方式访问

Route::match([‘get’, ‘post’], ‘/’, function(){

return ‘Hello World’;

});

Route::match([‘get’, ‘post’], ‘/shop’, ‘shop\ShopController@index’);

指定任意方式访问

Route::any(‘foo’, function(){

return ‘Hello World’;

});

Route::any(‘/shop’, ‘shop\ShopController@index’);

获取url地址 http://homestead.app/shop

$url = url(‘shop’);

访问方式欺骗（方法欺骗）

通常 HTML 表单没有支持 PUT 或 DELETE 请求，我们可以通过欺骗的方式达到 put delete 能访问

在 HTML 表单中被调用的时候，您将需要添加隐藏 _method 字段在表单中。 发送的 _method 字段对应的值会被当做 HTTP 请求方法

如：

<form action="/shop" method="POST">
    <input type="hidden" name="_method" value="PUT">
</form>

CSRF 保护

为了保护用程序不受到 CSRF (跨网站请求伪造) 攻击，Laravel 会自动在每一位用户的 session 中放置随机的 token ，这个 token 将被用来确保经过验证的用户是实际发出请求至应用程序的用户。

插入 CSRF Token 到表单

<input type="hidden" name="_token" value="<?php echo csrf_token(); ?>">

模板中使用

<input type="hidden" name="_token" value="{{ csrf_token() }}">

我们不需要手动验证 POST、PUT、DELETE 请求的 CSRF token。

VerifyCsrfToken HTTP 中间件将保存在 session 中的请求输入的 token 配对来自动验证 token 。

X-CSRF-TOKEN

除了寻找 CSRF token 作为「POST」参数，中间件也检查 X-XSRF-TOKEN 请求头。

比如，你可以把 token 存放在 meta 标签中, 然后使用 jQuery 将它加入到所有的请求头中：

<meta name="csrf-token" content="{{ csrf_token() }}" />

//jQuery.ajaxSetup() 方法设置全局 AJAX 默认选项。

$.ajaxSetup({
    headers: {
        'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
    }
});

所有的 AJAX 请求会自动加入 CSRF token：

$.ajax({  url: "/foo/bar",})

路由参数

基础路由参数(不传参则报错)

Route::get('/user/{id}', function($id){
    return 'User '.$id;
});
Route::get('/shop/{id}', 'shop\ShopController@index');

控制器方法中

function index($id){
    echo $id
}

注意： 路由参数不能包含 - 字符。使用下划线替代 (_)。

可选择的路由参数

Route::get('/shop/{id}', function($id = null){
    return $id;
});
Route::get('/shop/{id?}', 'shop\ShopController@index');

控制器方法中

function index($id=null){
    echo $id
}

带默认值的路由参数

Route::get('/shop/{id}', function($id = 1){
    return $id;
});
Route::get('/shop/{id?}', 'shop\ShopController@index');

控制器方法中

function index($id=1){
    echo $id
}

使用正则表达式限制参数

Route::get('user/{name}', function($name){
    return $name;
})
->where('name', '[A-Za-z]+');//限制参数只能是大小写字母
Route::get('user/{id}', function($id){
    return $id;
})

->where(‘id’, ‘[0-9]+’);//限制参数只能是数字

使用多个条件限制数组

Route::get('user/{id}/{name}', function($id, $name){
    //
})
->where(['id' => '[0-9]+', 'name' => '[a-z]+'])

定义全局模式

使用 pattern 方法。在 app/Providers/RouteServiceProvider 的 boot 方法里定义模式：

$router->pattern('id', '[0-9]+');

定义模式之后，会作用在所有使用这个特定参数的路由上：

Route::get('user/{id}', function($id){
    // 只有 {id} 是数字才被调用。
});

路由别名。(方便生成url和重定向)

Route::get('user/profile', ['as' => 'profile', function(){
    //
}]);

为控制器动作指定路由名称：

Route::get('shop/index', [
    'as' => 'center', 'uses' => 'shop\ShopController@index']
);

//控制器中使用

$url = route('center');

echo $url;  // http://homestead.app/shop/index 
$redirect = redirect()->route('center');

echo $redirect;重定向

currentRouteName 方法会返回目前请求的路由名称：$name = Route::currentRouteName();

控制器路由

控制器路由我认为主要是解决路由定义繁杂的情况，因为大型的应用业务复杂，控制器相当的多，我们不可能每一个控制器的方法都要定义一个路由。Laravel 的控制器路由可以完美解决问题

Route::controller('/', 'HomeController');

控制器方法的写法也要有所变化：

/**
* 显示首页。
*
* @return Response
*/
public function getIndex(){
    return view('home');
}
/**
* 显示关于界面
*
* @return Response
*/
public function getAbout(){
    return view('about');
}

前缀 get，post, any 等

资源控制器

Laravel 的资源控制器原生的支持了 RESTful 架构。其实 laravel 的资源控制器和其他控制器没什么直接区别，只是对控制器类的方法和结构略有规定，不过我们并不要手动创建资源控制器，我们可以利用 laravel 的命令行工具 —— artisan。

php artisan make:controller ArticleController

就可以创建一个名为 ArticleController 的资源控制器，文件默认在 app/Http/Controllers 下。我们打开 ArticleController.php，发现里面已经写好了许多方法，比如 index、create、show 等等。分别是什么意思？如何在路由定义才能访问到？

Route::resource('article', 'ArticleController');

访问的地址规则呢？如果你已经了解了 RESTful，再去阅读以下官方文档，基本就已经明白了。我就着上述的控制器、路由，来说明。先看一张表：

[thead]
[/thead]

请求方法	请求 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	保存你编辑的数据
DELETE	/article/{id}	destroy	删除

当定义了个资源路由 Route::resource(‘article’, ‘ArticleController’);。

访问地址 http://yourdomain/article ，相当于访问控制器 ArticleController 的 index 方法。

访问地址 http://yourdomain/article/create ，就会访问到 create 方法。

通过 POST 提交数据至地址 http://yourdomain/article，相当于由 store 方法处理。

路由组

中间件路由 Middleware

app/Http/Kernel.php 中的 $middleware 数组是全局中间件，也就是说，任何一条路由都会被应用这些中间件，比如里面的CSRF验证中间件。

有时候我们不需要全局中间件，这时候可以将某一个中间件注册至 app/Http/Kernel.php 文件中的 $routeMiddleware 数组，数组的键名是中间件的别名，键值是具体的中间件类，如

'auth' => 'App\Http\Middleware\AuthMiddleware'

我们在 app/Http/Kernel.php 文件中的 $routeMiddleware 数组注册了一个独立中间件，这一中间件可被单独用绑定在一个路由和路由组上。在路由定义的时候可以像这样：

Route::get('admin/profile', ['middleware' => 'auth', function(){
    //
}]);

当我们访问 http://yourdomain/admin/profile 的时候，首先会经过全局中间件，然后就是我们在 app/Http/Kernel.php 的 $routeMiddleware 数组中定义的名称为 auth 的中间件。

在群组共享属性数组的 middleware 参数定义中间件列表，这些中间件就会应用到群组内的所有路由上。

中间件将会按在列表内指定的顺序执行：

Route::group(['middleware' => ['foo', 'bar']], function(){    
    Route::get('/', function()    {        
        // Has Foo And Bar Middleware    
    });    
    Route::get('user/profile', function()    {        
        // Has Foo And Bar Middleware    
    });
});

命名空间路由 Namespaces

在 group 属性数组中使用 namespace 参数，指定在这群组中控制器的命名空间：

Route::group(['namespace' => 'Admin'], function(){    
    // Controllers Within The "App\Http\Controllers\Admin" Namespace    

    Route::group(['namespace' => 'User'], function()    {        
        // Controllers Within The "App\Http\Controllers\Admin\User" Namespace    
    });
});

注意： 在默认情况下， app/Providers/RouteServiceProvider 包含内置您命名空间群组的 routes.php 文件，无需使用完整的 App\Http\Controllers 命名空间前缀就可以注册控制器路由。

子域名路由

Route::group(['domain' => '{account}.homestead.app'], function(){  
    Route::get('shop/{id}', function($account, $id)    {        
        return 'domain:'.$account.'===='.'id:'.$id;    
    });
});

访问：http://myapp.homestead.app/shop/users

路由前缀

Route::group(['prefix' => 'shop'], function(){    
    Route::get('users', function()    {     
        //return 111;        
        // Matches The "/admin/users" URL     
    });
});

访问：homestead.app/shop/users

注册一个 URL 参数到路由前缀

Route::group(['prefix' => 'shop/{account_id}'], function(){    
    Route::get('users', function($account_id)    {        
        return $account_id;        
        //    
    });
});

访问：homestead.app/shop/22/users

你甚至可以在前缀中为已命名的参数定义限制：

Route::group([  
        'prefix' => 'shop/{account_id}',     
        'where' => ['account_id' => '[0-9]+'],  
    ],  
    function(){    
        Route::get('users', function($account_id)    {        
            return $account_id;        
            //
    });
});

//访问：homestead.app/shop/22/users

路由模型绑定

Laravel 模型绑定提供方便的方式将模型实体注入到您的路由中。

例如，比起注入 User ID ，你可以选择注入符合给定 ID 的 User 类实体。

使用路由的 model 方法指定特定参数要对应的类，在 app/Providers/RouteServiceProvider::boot 方法定义您的模型绑定：

public function boot(Router $router){
    parent::boot($router);
    $router->model('user', 'App\User');
}

然后定义一个有 {user} 参数的路由：

Route::get('profile/{user}', function(App\User $user){
    //
});

注意： 如果在数据库中找不到匹配的模型实体，将引发 404 错误。

如果您想要自定「没有找到」的行为，将闭包作为第三个参数传入 model 方法：

Route::model('user', 'User', function(){
    throw new NotFoundHttpException;
});

如果您想要使用您自己决定的逻辑，您应该使用 Route::bind方法。

闭包通过 bind 方法将传递 URI 区段数值，并应该返回您想要被注入路由的类实体：

Route::bind('user', function($value){
    return User::where('name', $value)->first();
});

抛出 404 错误

Route::get('/shop/{id}', function($id){
    //return 'User '.$id;
    abort(404);
});

在控制器使用 abort 辅助函数手动触发 404 错误。

abort(404);

自定义错误页面

resources/views/errors/404.blade.php