模塊組成
Auth模塊從功能上分為用戶認證和權(quán)限管理兩個部分;從文件組成上,IlluminateAuthPasswords目錄下是密碼重置或忘記密碼處理的小模塊,IlluminateAuth是負責用戶認證和權(quán)限管理的模塊,IlluminateFoundationAuth提供了登錄、修改密碼、重置密碼等一系統(tǒng)列具體邏輯實現(xiàn);下圖展示了Auth模塊各個文件的關系,并進行簡要說明;
用戶認證
HTTP本身是無狀態(tài),通常在系統(tǒng)交互的過程中,使用賬號或者Token標識來確定認證用戶;
配置文件解讀
return [ 'defaults' => [ 'guard' => 'web', ... ], 'guards' => [ 'web' => [ 'driver' => 'session', 'provider' => 'users', ], 'api' => [ 'driver' => 'token', 'provider' => 'users', ], ], 'providers' => [ 'users' => [ 'driver' => 'eloquent', 'model' => AppUser::class, ], ], ], ];
從下往上,理解;
providers是提供用戶數(shù)據(jù)的接口,要標注驅(qū)動對象和目標對象;此處,鍵名users是一套provider的名字,采用eloquent驅(qū)動,modal是AppUser::class;
guards部分針對認證管理部分進行配置;有兩種認證方式,一種叫web,還有一種是api;web認證是基于Session交互,根據(jù)sessionId獲取用戶id,在users這個provider查詢出此用戶;api認證是基于token值交互,也采用users這個provider;
defaults項顯示默認使用web認證;
認證
Session綁定認證信息:
// $credentials數(shù)組存放認證條件,比如郵箱或者用戶名、密碼 // $remember 表示是否要記住,生成 `remember_token` public function attempt(array $credentials = [], $remember = false) public function login(AuthenticatableContract $user, $remember = false) public function loginUsingId($id, $remember = false)
HTTP基本認證,認證信息放在請求頭部;后面的請求訪問通過sessionId;
public function basic($field = 'email', $extraConditions = [])
只在當前會話中認證,session中不記錄認證信息:
public function once(array $credentials = []) public function onceUsingId($id) public function onceBasic($field = 'email', $extraConditions = [])
認證過程中(包括注冊、忘記密碼),定義的事件有這些:
Attempting 嘗試驗證事件
Authenticated 驗證通過事件
Failed 驗證失敗事件
Lockout 失敗次數(shù)超過限制,鎖住該請求再次訪問事件
Logi 通過‘remember_token’成功登錄時,調(diào)用的事件
Logout 用戶退出事件
Registered 用戶注冊事件
還有一些其他的認證方法:
檢查是否存在認證用戶:Auth::check()
獲取當前認證用戶:Auth::user()
退出系統(tǒng):Auth::logout()
密碼處理
配置解讀
return [ 'defaults' => [ 'passwords' => 'users', ... ], 'passwords' => [ 'users' => [ 'provider' => 'users', 'table' => 'password_resets', 'expire' => 60, ], ], ]
從下往上,看配置;
passwords數(shù)組是重置密碼的配置;users是配置方案的別名,包含三個元素:provider(提供用戶的方案,是上面providers數(shù)組)、table(存放重置密碼token的表)、expire(token過期時間)
default 項會設置默認的 passwords 重置方案;
重置密碼的調(diào)用與實現(xiàn)
先看看Laravel的重置密碼功能是怎么實現(xiàn)的:
public function reset(array $credentials, Closure $callback) { // 驗證用戶名、密碼和 token 是否有效 $user = $this->validateReset($credentials); if (! $user instanceof CanResetPasswordContract) { return $user; } $password = $credentials['password']; // 回調(diào)函數(shù)執(zhí)行修改密碼,及持久化存儲 $callback($user, $password); // 刪除重置密碼時持久化存儲保存的 token $this->tokens->delete($user); return static::PASSWORD_RESET; }
再看看FoundationAuth模塊封裝的重置密碼模塊是怎么調(diào)用的:
// 暴露的重置密碼 API public function reset(Request $request) { // 驗證請求參數(shù) token、email、password、password_confirmation $this->validate($request, $this->rules(), $this->validationErrorMessages()); // 調(diào)用重置密碼的方法,第二個參數(shù)是回調(diào),做一些持久化存儲工作 $response = $this->broker()->reset( $this->credentials($request), function ($user, $password) { $this->resetPassword($user, $password); } ); // 封裝 Response return $response == Password::PASSWORD_RESET ? $this->sendResetResponse($response) : $this->sendResetFailedResponse($request, $response); } // 獲取重置密碼時的請求參數(shù) protected function credentials(Request $request) { return $request->only( 'email', 'password', 'password_confirmation', 'token' ); } // 重置密碼的真實性驗證后,進行的持久化工作 protected function resetPassword($user, $password) { // 修改后的密碼、重新生成 remember_token $user->forceFill([ 'password' => bcrypt($password), 'remember_token' => Str::random(60), ])->save(); // session 中的用戶信息也進行重新賦值 $this->guard()->login($user); }
“忘記密碼 => 發(fā)郵件 => 重置密碼” 的大體流程如下:
點擊“忘記密碼”,通過路由配置,跳到“忘記密碼”頁面,頁面上有“要發(fā)送的郵箱”這個字段要填寫;
驗證“要發(fā)送的郵箱”是否是數(shù)據(jù)庫中存在的,如果存在,即向該郵箱發(fā)送重置密碼郵件;
重置密碼郵件中有一個鏈接(點擊后會攜帶 token 到修改密碼頁面),同時數(shù)據(jù)庫會保存這個 token 的哈希加密后的值;
填寫“郵箱”,“密碼”,“確認密碼”三個字段后,攜帶 token 訪問重置密碼API,首頁判斷郵箱、密碼、確認密碼這三個字段,然后驗證 token是否有效;如果是,則重置成功;
權(quán)限管理
權(quán)限管理是依靠內(nèi)存空間維護的一個數(shù)組變量abilities來維護,結(jié)構(gòu)如下:
$abilities = array( '定義的動作名,比如以路由的 as 名(common.dashboard.list)' => function($user) { // 方法的參數(shù),第一位是 $user, 當前 user, 后面的參數(shù)可以自行決定 return true; // 返回 true 意味有權(quán)限, false 意味沒有權(quán)限 }, ...... );
但只用 $abilities,會使用定義的那部分代碼集中在一起太煩索,所以有policy策略類的出現(xiàn);
policy策略類定義一組實體及實體權(quán)限類的對應關系,比如以文章舉例:
有一個 Modal實體類叫 Post,可以為這個實體類定義一個PostPolicy權(quán)限類,在這個權(quán)限類定義一些動作為方法名;
class PostPolicy { // update 權(quán)限,文章作者才可以修改 public function update(User $user, Post $post) { return $user->id === $post->user_id; } }
然后在ServiceProvider中注冊,這樣系統(tǒng)就知道,如果你要檢查的類是Post對象,加上你給的動作名,系統(tǒng)會找到PostPolicy類的對應方法;
protected $policies = [ Post::class => PostPolicy::class, ];
怎么調(diào)用呢?
對于定義在abilities數(shù)組的權(quán)限:
當前用戶是否具備common.dashboard.list權(quán)限:Gate::allows('common.dashboard.list')
當前用戶是否具備common.dashboard.list權(quán)限:! Gate::denies('common.dashboard.list')
當前用戶是否具備common.dashboard.list權(quán)限:$request->user()->can('common.dashboard.list')
當前用戶是否具備common.dashboard.list權(quán)限:! $request->user()->cannot('common.dashboard.list')
指定用戶是否具備common.dashboard.list權(quán)限:Gate::forUser($user)->allows('common.dashboard.list')
對于policy策略類調(diào)用的權(quán)限:
當前用戶是否可以修改文章(Gate 調(diào)用):Gate::allows('update', $post)
當前用戶是否可以修改文章(user 調(diào)用):$user->can('update', $post)
當前用戶是否可以修改文章(用幫助函數(shù)):policy($post)->update($user, $post)
當前用戶是否可以修改文章(Controller 類方法中調(diào)用):$this->authorize('update', $post);
當前用戶是否可以修改文章(Controller 類同名方法中調(diào)用):$this->authorize($post);
指定用戶是否可以修改文章(Controller 類方法中調(diào)用):$this->authorizeForUser($user, 'update', $post);
有用的技巧
獲取當前系統(tǒng)注冊的權(quán)限,包括兩部分abilities和policies數(shù)組內(nèi)容,代碼如下:
$gate = app(IlluminateContractsAuthAccessGate::class); $reflection_gate = new ReflectionClass($gate); $policies = $reflection_gate->getProperty('policies'); $policies->setAccessible(true); // 獲取當前注冊的 policies 數(shù)組 dump($policies->getValue($gate)); $abilities = $reflection_gate->getProperty('abilities'); $abilities->setAccessible(true); // 獲取當前注冊的 abilities 數(shù)組 dump($abilities->getValue($gate));
推薦教程:《Laravel教程》
聲明:本網(wǎng)頁內(nèi)容旨在傳播知識,若有侵權(quán)等問題請及時與本網(wǎng)聯(lián)系,我們將在第一時間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com