摘要：同時，傳入?yún)?shù)，即已存在的查詢。因此，更為常見的做法是在控制器中處理路由請求。

這一節(jié)，我們進一步完善上一節(jié)創(chuàng)建的任務列表。主要知識點：

Eloquent Model

控制器

路由模型綁定

首先，我們?yōu)閿?shù)據(jù)庫表 tasks 新增一個字段 completed，用來表示任務是否完成:

$ php artisan make:migration add_completed_to_tasks_table --table=tasks

這次，我們使用 --table 指定已存在的表。接著添加具體字段:

// /database/migrations/2017_04_11_060132_add_completed_to_tasks_table.php
public function up()
{
    Schema::table("tasks", function (Blueprint $table) {
        $table->boolean("completed")->default(0);
    });
}

public function down()
{
    Schema::table("tasks", function (Blueprint $table) {
        $table->dropColumn("completed");
    });
}

執(zhí)行遷移:

$ php artisan migrate

如果我們想要回滾本次遷移，可以執(zhí)行:

$ php artisan migrate:rollback

將會執(zhí)行遷移任務的 down() 函數(shù)：

上一節(jié)，我們使用 DB 來操縱數(shù)據(jù)庫，在 Laravel 中，也叫做查詢構造器。實際上，Laravel 提供了更為強大的用來與數(shù)據(jù)庫交互的工具：Eloquent Model。

首先，我們來創(chuàng)建一個與 tasks 表格對應的 Model:

$ php artisan make:model Task

現(xiàn)在，我們就可以使用 Eloquent 了，啟動控制臺：

$ php artisan tinker

可以先對 Task 類實例化，然后再進行各種操作：

>>> $task = new AppTask;  # 新建一個 Task 實例

新建任務:

>>> $task->name = "新的任務"
>>> $task->completed = 1
>>> $task->save()  # 保存新實例

>>> $task 
=> AppTask {#674
     name: "新的任務",
     completed: 1,
     updated_at: "2017-04-11 06:14:10",
     created_at: "2017-04-11 06:14:10",
     id: 4,
   }

查詢:

>>> $task->all()->toJson();  # 獲取數(shù)據(jù)并轉化為 json 格式
>>> $task->where("completed",1)->get(); # 查看完成的任務
>>> $task->pluck("name")->first(); # 獲取第一條記錄的 name 字段

也可以不實例，直接調用「門面」方法來操作：

>>> AppTask::first();  # 獲取第一條記錄
>>> AppTask::latest()->get(); # 按先后順序顯示記錄

剛才的例子中，有一行是用來查詢已完成的任務的：

>>> $task->where("completed",1)->get();

該查詢在很多地方都有可能要用到，為了避免重復工作，我們將其封裝到 Model 中：

// /app/Task.php
class Task extends Model
{    
    public function completed()
    {
        return static::where("completed",1)->get();
    }

     public function unCompleted()
    {
        return static::where("completed",0)->get();
    }
}

我們定義了 completed() 和 unCompleted() 方法分別獲取已完成和未完成的任務。現(xiàn)在，需要重新啟動 tinker：

>>> $task = new AppTask;
>>> $task->completed();
>>> $task->uncompleted()->pluck("name")；

那么，我們是否可以直接使用 `Task::completed()呢？當然可以，不過需要把方法改成靜態(tài)的，因為靜態(tài)方法可以通過類和實例訪問：

 public static function completed()
{
    return static::where("completed",1)->get();
}

 public static function unCompleted()
{
    return static::where("completed",1)->get();
}

這樣就可以通過類直接訪問了,依舊要重啟 tinker 才能生效

$ php artisan tinker
>>> AppTask::completed()
>>> AppTask::unComplete()

對于上述的方法，Laravel 提供了更為便利的方式實現(xiàn)，叫做范圍查詢:

public function scopeCompleted($query)
{
    return $query->where("completed",1);
}

 public function scopeUnCompleted($query)
{
    return $query->where("completed",0);
}

使用范圍查詢，只需要在我們的方法前面加上 scope 就行，這樣就不用去定義靜態(tài)方法。同時，傳入 $query 參數(shù)，即已存在的查詢。我們只需要在此基礎上添加自己想要的查詢就可以了。現(xiàn)在，可以方便的使用了:

$ php artisan tinker
>>> use AppTask;
>>> Task::completed()->get();
>>> Task::unCompleted()->pluck("name")

經(jīng)過對 Eloquent 的初步學習之后，我們可以將之前的 DB 查詢換成 Eloquent 的：

// /routes/web.php
completed()->get();
    $unCompletedTasks = Task::latest()->unCompleted()->get();
    return view("tasks/index",compact("completedTasks","unCompletedTasks"));
});

Route::get("tasks/{task}", function($id) {
    $task = Task::findorFail($id);
    return view("tasks/show",compact("task"));
});

對應的視圖文件也稍微修改下:

// /resources/views/tasks/index.blade.php

    
任務列表
    

        
未完成
        

            @foreach ($unCompletedTasks as $task)
                

                    id]) }}">{{ $task->name }}          
                
            @endforeach
    
        
    
    

        
已完成
        

            @foreach ($completedTasks as $task)
                

                    id]) }}">{{ $task->name }}          
                
            @endforeach
    
        
    

之前，我們都是直接在路由處理請求，看上去好像沒什么問題。但是，如果當網(wǎng)站規(guī)模大起來之后，將路由和業(yè)務處理放在一起會變得難以維護。因此，更為常見的做法是在控制器中處理路由請求。

首先是控制器的創(chuàng)建:

$ php artisan make:controller TasksController

這樣就創(chuàng)建了一個空白的控制器了。

接下來，我們就可以在控制器中定義不同的方法來處理路由請求了。先在路由中指定請求由哪個控制器的方法處理：

Route::get("tasks","TasksController@index");
Route::get("tasks/{task}","TasksController@show");

控制器里面可以把剛才路由的方法拷貝進來:

// /app/Http/Controllers/TasksController.php
completed()->get();
        $unCompletedTasks = Task::latest()->unCompleted()->get();
        return view("tasks/index",compact("completedTasks","unCompletedTasks"));
    }

    public function show($task)
    {
        $task = Task::findorFail($task);
        return view("tasks/show",compact("task"));
    }
}

剛才的 show 方法，可以進一步簡寫成:

// /app/Http/Controllers/TasksController.php
public function show(Task $task)
{
    return view("tasks/show",compact("task"));
}

功能完全一樣，如果覺得好奇，可以打印出 $task

// /app/Http/Controllers/TasksController.php
public function show(Task $task)
{    
    dd($task);
}

你會發(fā)現(xiàn)，此時的 $task 已經(jīng)不是參數(shù)值了，而是從數(shù)據(jù)庫返回的對應實例。也就是說，我們?yōu)?$task 添加了類型提示 Task 之后，Laravel 自動幫我們進行了查詢。這就叫做自動路由模型綁定。

當然，我們也可以手動進行綁定！比如我只想要顯示完成的任務:

// /app/Providers/RouteServiceProvider.php
public function boot()
{   
    parent::boot();
    Route::bind("task",function($task){
        return AppTask::completed()->findOrFail($task);
    });
}

然后訪問未完成的任務，比如 task/1，就會報錯。

參考：

PHP: Static（靜態(tài)）關鍵字 - Manual

Eloquent: 入門 | Laravel 5.4 中文文檔

Laravel 5.2 Error "Missing argument 1 for IlluminateAuthAuthManager::createDriver()"

Laravel HTTP 路由功能 | Laravel 5.4 中文文檔