認証機能で学ぶ Laravel 5 アプリケーション

@shin1x1
2015/04/20 21th Kansai PHP Study
認証機能に学ぶ
Laravel 5 アプリケーション

Authentication
(c) 2015 Masashi Shinbara @shin1x1
• デフォルトプロジェクトに含まれている
• php artisan migrateすれば、すぐに使える
• 実際に見てみよう

ユーザ登録

ログイン

パスワードリセット

こんな機能も
• Cookieトークンによる自動ログイン 
（Remeber me）
• Basic認証（要実装）
• ソーシャル認証（要実装 / Twitter等）

認証機能に見る
アプリケーション実装例

Flow

Routing

Routing
Route::controllers([ 
'auth' => 'AuthAuthController', 
'password' => 'AuthPasswordController', 
]);
/auth, /password へのルーティング
コントローラのメソッドへ連結

Controller Method
• HTTPメソッド + パス
• GET /auth/register 
=> getRegister()
• POST /auth/register 
=> postRegister()

Routing - auth
Method URI Action
GET¦HEAD /auth/register AuthController@getRegister
POST /auth/register AuthController@postRegister
GET¦HEAD /auth/login AuthController@getLogin
POST /auth/login AuthController@postLogin
GET¦HEAD /auth/logout AuthController@getLogout

Routing - password
Method URI Action
GET¦HEAD /password/email PasswordController@getEmail
POST /password/email PasswordController@postEmail
GET¦HEAD /password/reset PasswordController@getReset
POST /password/reset PasswordController@postReset

Controller

Controller
• AuthControllerとPasswordController
• コンストラクタのみで、実処理はトレイトに実装
• 独自コントローラにもトレイトを再利用できる

Controller
<?php namespace AppHttpControllersAuth; 
 
// (snip) 
 
class AuthController extends Controller 
{ 
use AuthenticatesAndRegistersUsers; 
 
public function __construct(Guard $auth, Registrar $registrar) 
{ 
$this->auth = $auth; 
$this->registrar = $registrar; 
 
$this->middleware('guest', ['except' => 'getLogout']); 
} 
 
}
コンストラクタインジェクション

Controller
 
// (snip) 
 
{ 
 
{ 
 
} 
 
}
ミドルウェア(ログイン済みなら、リダイレクト）

Controller
 
// (snip) 
 
{ 
 
{ 
 
} 
 
}
トレイト

Constructor Injection
• コンストラクタでタイプヒンティングで指定
• IoC コンテナから、インスタンスを注入
• インスタンスが無ければ、フレームワークが生成

Constructor Injection
{ 
 
}
$auth = Guard クラスのインスタンス
$registar = Registarクラスのインスタンス

Middleware
• Decoratorパターン
• 適用ミドルウェアをAppHttpKernelで定義
• ミドルウェアは、次のミドルウェアを呼ぶ
• 一つの処理を行うミドルウェアを重ねていく

Middleware
public function handle($request, Closure $next) 
{ 
if ($this->auth->check()) { 
return new RedirectResponse(url('/home')); 
} 
 
return $next($request); 
}
ログイン済みなら、/homeへリダイレクト
そうで無ければ、次のミドルウェアを呼ぶ

Middleware Chain
CheckForMaintenanceMode
EncryptCookies
AddQueuedCookiesToResponse
StartSession
ShareErrorsForSession
RedirectIfAuthenticate
Controller method

ミドルウェアチェイン
メンテナンスモード切り替え
クッキーの複合、暗号
クッキーをレスポンスヘッダにセット
セッション開始、後処理
エラー情報をビューにセット
ログイン済みならリダイレクト
Controller method

Trait
• AuthControllerとPasswordController
• コンストラクタのみで、実処理はトレイトに実装
• 独自コントローラにもトレイトを再利用できる

Trait
public function getRegister() 
{ 
return view('auth.register'); 
} 
 
public function postRegister(Request $request) 
{ 
$validator = $this->registrar->validator($request->all()); 
 
if ($validator->fails()) 
{ 
$this->throwValidationException( 
$request, $validator 
); 
} 
 
$this->auth->login($this->registrar->create($request->all())); 
 
return redirect($this->redirectPath()); 
}
method

Trait
public function getRegister() 
{ 
return view('auth.register'); 
} 
 
{ 
 
{ 
); 
} 
 
 
}
method injection

Service

Service
• コントローラから起動 
（コントローラ以外からの呼び出しも可）
• ビジネスロジックを実装
• 永続化などは、Eloquent（モデル）に移譲
• GuardクラスとRegistrarクラス

Service - Registrar
class Registrar implements RegistrarContract 
{ 
public function validator(array $data) 
{ 
return Validator::make($data, [ 
'name' => 'required|max:255', 
'email' => 'required|email|max:255|unique:users', 
'password' => 'required|confirmed|min:6', 
]); 
} 
 
public function create(array $data) 
{ 
return User::create([ 
'name' => $data['name'], 
'email' => $data['email'], 
'password' => bcrypt($data['password']), 
]); 
} 
}
validator builder

Service - Registrar
class Registrar implements RegistrarContract 
{ 
public function validator(array $data) 
{ 
return Validator::make($data, [ 
'name' => 'required|max:255', 
'email' => 'required|email|max:255|unique:users', 
'password' => 'required|confirmed|min:6', 
]); 
} 
 
public function create(array $data) 
{ 
return User::create([ 
'name' => $data['name'], 
'email' => $data['email'], 
'password' => bcrypt($data['password']), 
]); 
} 
}
business logic

Controller(with Trait)
{ 
 
{ 
); 
} 
 
 
}
call service
call servicecall service

Model(Eloquent)

Model(Eloquent)
• Contracts（インターフェース）を実装
• プロパティ定義のみ
• 実処理は、トレイトに実装

Model(Eloquent)
class User extends Model implements AuthenticatableContract,
CanResetPasswordContract 
{ 
use Authenticatable, CanResetPassword; 
protected $table = 'users'; 
protected $fillable = ['name', 'email', 'password']; 
protected $hidden = ['password', 'remember_token']; 
}
Contract(interface)
Trait

まとめ
• 認証実装は、良いサンプル実装
• 役割を分け、シンプルな実装を
• こうしないといけないわけじゃない
• Laravelの実装で、アーキテクチャを学ぶ

@shin1x1

認証機能で学ぶ Laravel 5 アプリケーション

More Related Content

What's hot

Viewers also liked

Similar to 認証機能で学ぶ Laravel 5 アプリケーション

More from Masashi Shinbara

認証機能で学ぶ Laravel 5 アプリケーション