Laravel 5.2 二、HTTP路由、创建控制器 与 资源路由

一、HTTP路由

所有路由都定义在 App\Providers\RouteServiceProvider 类载入的 app/Http/routes.php文件中。

 

1. 基本路由

简单的 Laravel 路由只接受一个 URI 和一个闭包

Route::get( 'foo' ,  function  () {
    return  'Hello, Laravel!' ;
});

 

对于常见的 HTTP 请求，Laravel 有以下几种路由

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. 路由参数

//单个路由参数
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. 命名路由

//命名闭包路由
Route:get( 'user' ,  array ( 'as'  =>  'alial' ,  function (){});
//或 name 方法链
Route:get( 'user' ,  function (){})->name( 'alias' );

//命名控制器方法路由
Route:get( 'user' ,  array ( 'uses'  =>  'Admin\IndexController@index' ,  'as'  =>  'alias' ));
//或 name 方法链
Route:get( 'user' ,  'Admin\IndexController@index' )->name( 'alias' ));

 

2. 路由分组

2.1 路由前缀和命名空间

例如，有两条指向控制器方法的路由

Route::get( 'admin/login' ,  'Admin\IndexController@login' );
Route::get( 'admin/index' ,  'Admin\IndexController@index' );

 

拿第一条来说，

参数一：admin/login  表示这个 URI 在请求网站根目录下的 admin/login 资源，完整地址就是  http://域名/admin/login （这里开启了 Apache 的路由重写，隐藏了 “index.php“ ），这个请求被映射到第二个参数中指定的控制器方法。注意，网站根目录是入口文件所在目录，在 Laravel 中就是 public 目录，配置服务器时最好也指向这里。

参数二：Admin\IndexController@login 表示这个控制器方法是在 App\Http\Controllers 命名空间下的，连起来就是 App\Http\Controllers\Admin\IndexController 控制器里的 login 方法。

 

显然，两条路由的 URI 和 控制器方法 都有相同的部分，那么，启用路由分组可以提取出公共部分：

// 第一个数组参数中，prefix 键定义 URI 的公共部分，namespace 键定义方法名（命名空间语法）的公共部分
Route::group( array ( 'prefix'  =>  'admin' ,  'namespace'  =>  'Admin' ),  function (){
    Route::get( 'login' ,  'IndexController@login' );
    Route::get( 'index' ,  'IndexController@index' );
});

 

2.2 资源路由

资源路由就是映射到资源控制器的路由，Laravel 资源控制器内置了对资源增删改查的 7 个方法以及 7 条路由。

首先，创建资源控制器 ArticleController

php artisan make:controller Admin/ArticleController  --resource

这样就生成了资源控制器在 app/Http/Controllers/Admin/ArticleController.php 文件(Admin 文件夹不存在时会自动创建)，内置的 7 个方法如下 ：

namespace  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 )
    {
        //
    }
}

 

然后，定义资源路由 。这里我还是选择在路由分组下定义，定义一条就好

Route::group( array ( 'prefix'  =>  'admin' ,  'namespace'  =>  'Admin' ),  function (){
    Route::get( 'login' ,  'IndexController@login' );
    Route::get( 'index' ,  'IndexController@index' );
    // 资源路由
    Route::resource( 'article' ,  'ArticleController' );
});

　　

最后，查看路由。有了资源控制器 和 资源路由，就可以看一下对以上 7 个方法的 HTTP 请求方式了。

使用 Artisan 命令 php artisan route:list  列出当前的所有路由，请求方式、URI、控制器方法、中间件都罗列出来了。