Lumen HTTP 控制器

1、簡介

將所有的請求處理邏輯都放在單個routes.php中肯定是不合理的，你也許還希望使用控制器類組織管理這些行為?？刂破骺梢詫⑾嚓P(guān)的HTTP請求封裝到一個類中進行處理。通?？刂破鞔娣旁?code>app/Http/Controllers目錄中。

2、基本控制器

下面是一個基本控制器類的例子。所有的Lumen控制器應該繼承自Lumen安裝默認的基本控制器：

<?php

namespace App\Http\Controllers;

use App\User;

class UserController extends Controller
{
    /**
     * 為指定用戶顯示詳情
     *
     * @param  int  $id
     * @return Response
     */
    public function showProfile($id)
    {
        return view('user.profile', ['user' => User::findOrFail($id)]);
    }
}

我們可以像這樣路由到控制器動作：

$app->get('user/{id}', 'UserController@showProfile');

現(xiàn)在，如果一個請求匹配指定的路由URI，UserController的showProfile方法就會被執(zhí)行。當然，路由參數(shù)也會被傳遞給這個方法。

2.1 控制器&命名空間

你應該注意到我們在定義控制器路由的時候沒有指定完整的控制器命名空間，我們只需要定義App\Http\Controllers之后的類名部分。默認情況下，bootstrap/app.php將會在一個路由分組中載入routes.php文件，該路由分組包含了控制器的根命名空間。

如果你在App\Http\Controllers目錄下選擇使用PHP命名空間嵌套或組織控制器，只需要使用相對于App\Http\Controllers根命名空間的指定類名即可。因此，如果你的完整控制器類是App\Http\Controllers\Photos\AdminController，你可以像這樣注冊路由：

$app->get('foo', 'Photos\AdminController@method');

2.2 命名控制器路由

和閉包路由一樣，可以指定控制器路由的名字：

$app->get('foo', ['uses' => 'FooController@method', 'as' => 'name']);

一旦你為控制器路由分配了名字，那么你就可以使用幫助函數(shù)action很方便的生成URL到action，這里我們也只需要指定相對 App\Http\Controllers的命名空間即可：

$url = action('FooController@method');

你還可以使用幫助函數(shù)route來為已命名的控制器路由生成URL：

$url = route('name');

3、控制器中間件

中間件可以像這樣分配給控制器路由：

$app->get('profile', [
    'middleware' => 'auth',
    'uses' => 'UserController@showProfile'
]);

但是，將中間件放在控制器構(gòu)造函數(shù)中更方便，在控制器的構(gòu)造函數(shù)中使用middleware方法你可以很輕松的分配中間件給該控制器。你甚至可以限定該中間件到該控制器類的特定方法：

class UserController extends Controller
{
    /**
     * 實例化一個新的 UserController 實例
     *
     * @return void
     */
    public function __construct()
    {
        $this->middleware('auth');

        $this->middleware('log', ['only' => ['fooAction', 'barAction']]);

        $this->middleware('subscribed', ['except' => ['fooAction', 'barAction']]);
    }
}

4、依賴注入&控制器

4.1 構(gòu)造函數(shù)注入

Lumen使用服務容器解析所有的Lumen控制器，因此，可以在控制器的構(gòu)造函數(shù)中類型提示任何依賴，這些依賴會被自動解析并注入到控制器實例中：

<?php

namespace App\Http\Controllers;

use Illuminate\Routing\Controller;
use App\Repositories\UserRepository;

class UserController extends Controller
{
    /**
     * The user repository instance.
     */
    protected $users;

    /**
     * 創(chuàng)建新的控制器實例
     *
     * @param  UserRepository  $users
     * @return void
     * @translator http://laravelacademy.org
     */
    public function __construct(UserRepository $users)
    {
        $this->users = $users;
    }
}

當然，你還可以類型提示任何Laravel契約，如果容器可以解析，就可以進行類型提示。

4.2 方法注入

除了構(gòu)造函數(shù)注入之外，還可以在控制器的動作方法中進行依賴的類型提示，例如，我們可以在某個方法中類型提示Illuminate\Http\Request實例：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Routing\Controller;

class UserController extends Controller
{
    /**
     * 存儲新用戶
     *
     * @param  Request  $request
     * @return Response
     */
    public function store(Request $request)
    {
        $name = $request->input('name');

        //
    }
}

如果控制器方法期望輸入路由參數(shù)，只需要將路由參數(shù)放到其他依賴之后，例如，如果你的路由定義如下：

$app->put('user/{id}', 'UserController@update');

你需要通過定義控制器方法如下所示來類型提示Illuminate\Http\Request并訪問路由參數(shù)id：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Routing\Controller;

class UserController extends Controller
{
    /**
     * 更新指定用戶
     *
     * @param  Request  $request
     * @param  int  $id
     * @return Response
     * @translator http://laravelacademy.org
     */
    public function update(Request $request, $id)
    {
        //
    }
}