[toc] ## 配置 1. Lumen 框架的所有配置項都放置在了`.env`文件，使用`$corpId = env('corpid');`獲取 ## 路由配置 * 在`routes/web.php`新增路由。 ``` $router->get('foo', function () { return 'Hello World'; }); ``` * 可以注冊多種路由`get` `post` `put` `patch` `delete` `option` ### 路由參數 `{id}`必填參數 `'posts/{postId}/comments/{commentId}'`定義多個參數 `'user\[/{name}\]'`可選參數，僅在路由末尾支持 `'user/{name:\[A-Za-z\]+}'`正則表達式約束 `$router->get('/getSignRecord', 'SignController@getSignRecord');`指定路由到控制器方法 ### 路由別名 ``` $router->get('profile', ['as' => 'profile', function () { // }]); ``` ``` // 生成 URLs $url = route('profile'); // 重定向 return redirect()->route('profile'); ``` ### lumen路由配置nginx ``` set $root_path '項目路徑/public'; root $root_path; location / { try_files $uri $uri/ /index.php?$query_string; } ``` ## 數據查詢 * 自定義查詢`->select(DB::raw('CONVERT(varchar(30),createtime,120) as createtime'))` ### 調用自定義函數 ``` $sql='{ call Extend_WorkFlow_Insert('.$type.', '.(int)$userGroupId.', '.$days.') }'; $conn=DB::connection('sqlsrv'); $res = $conn->select($sql); ``` ## 用戶認證 * lumen是無狀態的api，不支持session，必須使用無狀態的機制來實現認證，如 API 令牌（Token） * 在使用 Lumen 的認證功能前，取消`bootstrap/app.php`文件中的`AuthServiceProvider`調用代碼的注釋。 ## 自定義公共函數 1. 在app目錄下新建`helpers.php`，公共函數放置里面。 2. 修改`composer.json`文件，在autoload里加入files字段 ``` "autoload": { "classmap": [ "database/seeds", "database/factories" ], "files": [ "app/helpers.php" ], "psr-4": { "App\\": "app/" } }, ``` 3. 執行`composer dump-autoload` 4. 或者第二步和第三步換成在`bootstrap/app.php`中添加`require_once __DIR__.'../app/helpers.php';` ## Eloquent 1. `const UPDATED_AT = null;`關閉其中一個字段保留另一個 ## jwt封裝類 ~~~ <?php namespace App\Utility; class JwtBase { //頭部 private static $header=array( 'alg'=>'HS256', //生成signature的算法 'typ'=>'JWT' //類型 ); //使用HMAC生成信息摘要時所使用的密鑰 private static $key='KEY'; /** * 獲取jwt token * @param array $payload jwt載荷 格式如下非必須 * [ * 'iss'=>'jwt_admin', //該JWT的簽發者 * 'iat'=>time(), //簽發時間 * 'exp'=>time()+7200, //過期時間 * 'nbf'=>time()+60, //該時間之前不接收處理該Token * 'sub'=>'www.admin.com', //面向的用戶 * 'jti'=>md5(uniqid('JWT').time()) //該Token唯一標識 * ] * @return bool|string */ public static function getToken(array $payload) { $arr = [ 'iss'=>'tianyuan', //該JWT的簽發者 'iat'=>time(), //簽發時間 'exp'=>time()+3600*24*15, //過期時間 'nbf'=>time(), //該時間之前不接收處理該Token 'sub'=>'', //面向的用戶 'jti'=>md5(uniqid('JWT').time()) //該Token唯一標識 ]; $payload = array_merge($arr,$payload); if(is_array($payload)) { $base64header=self::base64UrlEncode(json_encode(self::$header,JSON_UNESCAPED_UNICODE)); $base64payload=self::base64UrlEncode(json_encode($payload,JSON_UNESCAPED_UNICODE)); $token=$base64header.'.'.$base64payload.'.'.self::signature($base64header.'.'.$base64payload,self::$key,self::$header['alg']); return $token; }else{ return false; } } /** * 驗證token是否有效,默認驗證exp,nbf,iat時間 * @param string $Token 需要驗證的token * @return bool|string */ public static function verifyToken(string $Token) { $tokens = explode('.', $Token); if (count($tokens) != 3) return false; list($base64header, $base64payload, $sign) = $tokens; //獲取jwt算法 $base64decodeheader = json_decode(self::base64UrlDecode($base64header), JSON_OBJECT_AS_ARRAY); if (empty($base64decodeheader['alg'])) return false; //簽名驗證 if (self::signature($base64header . '.' . $base64payload, self::$key, $base64decodeheader['alg']) !== $sign) return false; $payload = json_decode(self::base64UrlDecode($base64payload), JSON_OBJECT_AS_ARRAY); //簽發時間大于當前服務器時間驗證失敗 if (isset($payload['iat']) && $payload['iat'] > time()) return false; //過期時間小宇當前服務器時間驗證失敗 if (isset($payload['exp']) && $payload['exp'] < time()) return false; //該nbf時間之前不接收處理該Token if (isset($payload['nbf']) && $payload['nbf'] > time()) return false; return $payload; } /** * base64UrlEncode https://jwt.io/ 中base64UrlEncode編碼實現 * @param string $input 需要編碼的字符串 * @return string */ private static function base64UrlEncode(string $input) { return str_replace('=', '', strtr(base64_encode($input), '+/', '-_')); } /** * base64UrlEncode https://jwt.io/ 中base64UrlEncode解碼實現 * @param string $input 需要解碼的字符串 * @return bool|string */ private static function base64UrlDecode(string $input) { $remainder = strlen($input) % 4; if ($remainder) { $addlen = 4 - $remainder; $input .= str_repeat('=', $addlen); } return base64_decode(strtr($input, '-_', '+/')); } /** * HMACSHA256簽名 https://jwt.io/ 中HMACSHA256簽名實現 * @param string $input 為base64UrlEncode(header).".".base64UrlEncode(payload) * @param string $key * @param string $alg 算法方式 * @return mixed */ private static function signature(string $input, string $key, string $alg = 'HS256') { $alg_config=array( 'HS256'=>'sha256' ); return self::base64UrlEncode(hash_hmac($alg_config[$alg], $input, $key,true)); } } ~~~ ### 報錯`Call to a member function connection() on null` 在`bootstrap\app.php`中，`$app->withEloquent();`的注釋打開即可