[TOC] #### 1. JWT介紹 --- 本文是在 TP6.0 使用 JWT 的示例 JWT全稱: JSON Web Token，以 token 的方式代替傳統的 cookie、session 模式，用于各服務器、客戶端傳遞信息及簽名驗證 #### 2. 新增自定義函數 `fault()` --- 在 **app/common.php** 中新增以下函數，用于拋出異常 ```php /** * 拋出異常錯誤 * * @param string $msg * @param integer $code */ function fault(string $msg = "", $code = 201) { throw new \Exception($msg, $code); } ``` #### 3. 新增配置文件 `jwt.php` --- 在全局配置目錄 config 目錄下新建 jwt.php 文件，文件內容如下 ``` <?php // +---------------------------------------------------------------------- // | JWT (Json Web Token) 配置 // +---------------------------------------------------------------------- // | Author: liang 23426945@qq.com // +---------------------------------------------------------------------- return [ 'iss' => 'liang', // 簽發者 'aud' => 'chen', // 接收者 'key' => 'yang', // 訪問密鑰 'prefix' => 'jwt_', // 緩存前綴 'exp' => 864000, // 過期時間,864000秒=10天 'single_sign_on' => false, // 單點登錄 true 開啟 false 關閉 ]; ``` #### 4. JWT 功能封裝類 --- 安裝擴展包 ``` composer require firebase/php-jwt:'5.*' ``` ``` <?php // +---------------------------------------------------------------------- // | JWT (Json Web Token) 功能封裝類 // +---------------------------------------------------------------------- // | Author: liang 23426945@qq.com // +---------------------------------------------------------------------- declare(strict_types=1); use Firebase\JWT\JWT; class JwtAuth { // +------------------------------------------------------------------ // | 初始化配置 // +------------------------------------------------------------------ /** * 初始化配置 */ public function __construct() { $this->iss = config('jwt.iss'); //簽發者 可選 $this->aud = config('jwt.aud'); //接收該JWT的一方，可選 $this->exp = config('jwt.exp'); //過期時間,864000秒 = 10天 $this->key = config('jwt.key'); //訪問秘鑰 $this->prefix = config('jwt.prefix'); //緩存前綴 } // +------------------------------------------------------------------ // | 創建、解析 token // +------------------------------------------------------------------ /** * 創建token * * @param array $data * @return string token */ public function encode(array $data) { $time = time(); //當前時間 $token = [ 'iss' => $this->iss, //簽發者 可選 'aud' => $this->aud, //接收該JWT的一方，可選 'iat' => $time, //簽發時間 'nbf' => $time, //(Not Before)：某個時間點后才能訪問,比如設置time+30，表示當前時間30秒后才能使用 'exp' => $time + $this->exp, //過期時間 'data' => $data, //附加數據 ]; $token = JWT::encode($token, $this->key); // 創建token $this->cache($data['uid'], $token); // 將token存入緩存 return $token; // 返回token } /** * 解析token * * @param string $token 前端請求攜帶的token */ public function decode(string $token) { try { JWT::$leeway = 0; //當前時間減去60，把時間留點余地 return JWT::decode($token, $this->key, ['HS256']); //HS256方式，這里要和簽發的時候對應 } catch (\Firebase\JWT\SignatureInvalidException $e) { //簽名不正確 fault('簽名不正確'); } catch (\Firebase\JWT\BeforeValidException $e) { // 簽名在某個時間點之后才能用 fault('登錄未生效'); } catch (\Firebase\JWT\ExpiredException $e) { // token過期 fault('登錄過期'); } catch (\Exception $e) { //其他錯誤 fault($e->getMessage()); } } // +------------------------------------------------------------------ // | 檢測token // +------------------------------------------------------------------ /** * 將用戶token存入緩存,用于單點登錄校驗 * * @param int $id 用戶id * @param string $token 服務器端生成的token */ private function cache(int $uid, string $token) { // 緩存token cache($this->prefix . $uid, $token); } /** * 檢測token是否已過期(單點登錄) * * @param int $id 用戶id * @param string $token 前端請求攜帶的token * @return boolean true token 有效 false 已過期 */ public function checkToken(int $id, string $token) { // 判斷是否開啟單點登錄校驗 true 開啟 false 關閉 if (config('jwt.single_sign_on')) { // 獲取緩存中該用戶的token $cacheToken = cache($this->prefix . $id); // true 有效 false 已過期 return $token === $cacheToken; } else { return true; // 沒有開啟單點登錄直接返回true } } } ``` #### 5. JWT 鑒權控制器 --- 創建鑒權控制器，所有需要進行 token 校驗的控制器只需要繼承該控制器即可 ``` php think make:controller api@Auth --plain ``` 鑒權控制器文件內容如下: ``` <?php // +---------------------------------------------------------------------- // | JWT (Json Web Token) // +---------------------------------------------------------------------- // | Author: liang 23426945@qq.com // +---------------------------------------------------------------------- declare(strict_types=1); namespace app\api\controller; use JwtAuth; use app\BaseController; /** * JWT 鑒權控制器 */ class Auth extends BaseController { /** * 校驗token是否有效 */ protected function initialize() { // 接收請求頭中的Token $token = request()->header('token'); // 初步校驗token empty($token) && fault('token不能為空'); // 解析token,返回生成token時的附加數據 $this->jwt = app(JwtAuth::class)->decode($token)->data; // 獲取附加數據中的用戶id并轉為整型 $this->uid = (int) $this->jwt->uid; // 攜帶的token和緩存中的token進行比對(單點登錄校驗) if (!app(JwtAuth::class)->checkToken($this->uid, $token)) { fault('登錄狀態已過期', 401); } } } ```