中介層 (Middleware)
最后更新于：2022-04-01 23:11:54
# 中介層（Middleware）
這裏會介紹如何在 Laravel 5 使用中介層處理資料，Middleware 在 Laravel 4 叫做 Filter，他可以在處理資料之前，先過濾條件判斷，符合條件的再繼續處理之後的 Http 請求。
就像實作一個部落格，使用者發表文章的時候，一定要登入，否則就會被導到登入頁（或首頁），判斷登入條件的部分在 Laravel 5 可以用中介層去實現。
### 檢視中介層類別
我們可以看看內建的驗證使用者是否有登入的 Authenticate 中介層
~~~
auth = $auth;
}
/**
* Handle an incoming request.
* 處理 request
*
* @param \Illuminate\Http\Request $request
* @param \Closure $next
* @return mixed
*/
public function handle($request, Closure $next)
{
if ($this->auth->guest())
{
if ($request->ajax())
{
return response('Unauthorized.', 401);
}
else
{
return redirect()->guest('auth/login');
}
}
return $next($request);
}
}
~~~
有設定 Http Request 中介層時，所有的請求都會丟給中介層的 `handle()` 函式做處理，第一個變數傳入的是 Request 本身，第二個變數是若檢查驗證成功之後要執行的函數，並把 Request 丟給下一層處理 `$next($request)`。
### 註冊中介層變數
中介層設定好之後，必須要到 `app\Http\Kernel.php` 去註冊你的中介層
~~~
'App\Http\Middleware\Authenticate',
'auth.basic' => 'Illuminate\Auth\Middleware\AuthenticateWithBasicAuth',
'guest' => 'App\Http\Middleware\RedirectIfAuthenticated',
];
}
~~~
在 `app\Http\Kernel.php` 類別中，`$middleware` 變數是設定全域中介層堆疊清單，每一個 Http Request 都會依序經過 `$middleware` 所有的中介層做判斷
`$middleware` 中介層判斷完後都沒問題，才丟給路由中介層 `$routeMiddleware` 做處理（若路由有設定要使用哪個中介層的話，沒有設定則略過）。
當我們有自己的中介層，我們可以依自己需求看要將中介層設定加到哪一個變數設定中，如果需要每一個 Request 都做檢查的話，則將中介層設定到 `$middleware`，否則設定在。 `$routeMiddleware` 並指定中介層名稱即可。
### 在 Controller 使用中介層
我們可以強制設定，當使用者要存取文章的資源時都必須要登入，所以在 ArticleController 控制器的建構子，我們可以用 `$this->middleware('auth');` 設定全部 ArticleController 中的函式皆使用 `auth` 中介層。
> `auth` 中介層名稱是參照 `app\Http\Kernel.php` 中的 `$routeMiddleware` 變數設定
~~~
class ArticleController extends Controller {
public function __construct() {
$this->middleware('auth');
}
// 新增文章
public function store(Requests $request)
{
}
}
~~~
我們也可以使用 `only` 方式，指定中介層只有在指定的函式中才使用，或是使用 `except` 方式指定除了某些函式不使用中介層外，其他都要使用中介層當作過濾
~~~
// 只有設定的函式使用中介層
$this->middleware('auth', ['only'=>'create']);
// 只有設定的函式"不要"使用中介層
$this->middleware('auth', ['except'=>'index']);
~~~
### 在 Route 使用中介層
~~~
// app\Http\routes.php
Route::get('about', [
'middleware' => 'auth',
'uses'=> 'HomeController@about'
]);
~~~
### 建立自己的中介層
我們可以使用指令建立自己的 Middleware，假如我建立一個 `KeJyunMiddleware` 為名稱的中介層，可以在命令列輸入：
~~~
$ php artisan make:middleware KeJyunMiddleware
~~~
建立的中介層會放在 `app\Http\Middleware\KeJyunMiddleware.php` 中
~~~
'App\Http\Middleware\KeJyunMiddleware',
];
}
~~~
### 參考資料
- [Ogres Are Like Middleware - Laracasts](https://laracasts.com/series/laravel-5-fundamentals/episodes/16)
';