thinkphp的jwt（JSON Web Token）身份驗證包。支持Header、Cookie、Param等多種傳參方式。包含：驗證、驗證并且自動刷新等多種中間件。 [thinkphp6.0的demo下載](https://gitee.com/thans/jwt-auth/attach_files/306748/download) ## [](https://gitee.com/thans/jwt-auth#%E6%94%AF%E6%8C%81swoole)支持Swoole ## [](https://gitee.com/thans/jwt-auth#%E7%8E%AF%E5%A2%83%E8%A6%81%E6%B1%82)環境要求 1. php >= 7.0 2. thinkphp ^5.1.10 || ^6.0.0 > 目前支持如下三大類型加密方式：RSA,HASH,DSA。再各分256、384、512位。 默認是HS256，即hash 256位加密。 > 需要修改加密方式，請修改參數：ALGO，參數選項： * HS256 > 備注：hash 256位 * HS384 > 備注：hash 384位 * HS512 > 備注：hash 512位 * RS256 > 備注：rsa 256位 * RS384 > 備注：rsa 384位 * RS512 > 備注：rsa 512位 * ES256 > 備注：dsa 256位 * ES384 > 備注：dsa 384位 * ES512 > 備注：dsa 512位 > 重要：RSA和DSA 都是非對稱加密方式，除了修改參數ALGO外，需要配置：PUBLIC\_KEY、PRIVATE\_KEY兩個參數， 這兩個參數支持文本（不要開頭、結尾和換行）或密鑰文件路徑。如果密鑰設置了密碼，請配置好參數：PASSWORD > env文件不支持內容有等于號，遇到這種情況： 1、使用路徑 2、生成沒有等于號的密鑰。 ## [](https://gitee.com/thans/jwt-auth#%E5%AE%89%E8%A3%85)安裝 第一步: ~~~ $ composer require thans/tp-jwt-auth ~~~ 第二步: ~~~ $ php think jwt:create ~~~ 此舉將生成jwt.php和.env配置文件。不推薦直接修改jwt.php 同時，env中會隨機生成secret。請不要隨意更新secret，也請保障secret安全。 ## [](https://gitee.com/thans/jwt-auth#%E4%BD%BF%E7%94%A8%E6%96%B9%E5%BC%8F)使用方式 對于需要驗證的路由或者模塊添加中間件： ~~~ thans\jwt\middleware\JWTAuth::class, ~~~ 示例： ~~~ use thans\jwt\facade\JWTAuth; $token = JWTAuth::builder(['uid' => 1]);//參數為用戶認證的信息，請自行添加 JWTAuth::auth();//token驗證 JWTAuth::refresh();//刷新token，會將舊token加入黑名單 $tokenStr = JWTAuth::token()->get(); //可以獲取請求中的完整token字符串 $payload = JWTAuth::auth(); //可驗證token, 并獲取token中的payload部分 $uid = $payload['uid']->getValue(); //可以繼而獲取payload里自定義的字段，比如uid ~~~ token刷新說明： > token默認有效期為60秒，如果需要修改請修改env文件。 refresh\_ttl為刷新token有效期參數，單位為分鐘。默認有效期14天。 token過期后，舊token將會被加入黑名單。 如果需要自動刷新，請使用中間件 thans\\jwt\\middleware\\JWTAuthAndRefresh::class, 自動刷新后會通過header返回，請保存好。（注意，此中間件過期后第一次訪問正常，第二次進入黑名單。） token傳參方式如下： > 可通過jwt.php配置文件內token\_mode參數來調整參數接收方式及優先級 token\_mode默認值為\['header', 'cookie', 'param'\]; > 在某些前后端分離的情況下可選擇取消cookie接收方式來避免token沖突 * 將token加入到url中作為參數。鍵名為token * 將token加入到cookie。鍵名為token * 將token加入header，如下：Authorization:bearer token值 * 以上三種方式，任選其一即可。推薦加入header中。 #### [](https://gitee.com/thans/jwt-auth#%E5%85%B6%E4%BB%96%E6%93%8D%E4%BD%9C)其他操作 1. 拉黑Token JWTAuth::invalidate($token); 2. 查詢Token是否黑名單 JWTAuth::validate($token); #### [](https://gitee.com/thans/jwt-auth#%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98)常見問題 * 使用RSA256方式的時候，請使用文本形式。