open api security options added

Author: hafijul233

config/request-docs.php

@@ -165,11 +165,11 @@
         // if type set null then doc will exclude global security schema.
         // Ref: https://spec.openapis.org/oas/v3.0.3#security-scheme-object
         'security' => [
-            //available options [null, bearer, basic, apikey]
+            //available options [null, bearer, basic, apikey, jwt]
             'type' => 'bearer',
-            //Note: only works for "apikey", available options [query, header, cookie]
+            'name' => 'api_key',
+            //Note: only works for "apikey" & "jwt", available options [query, header, cookie]
             'position' => 'header',
-            'key_name' => 'api_key'
         ],
     ],
 

src/LaravelRequestDocsToOpenApi.php

@@ -7,7 +7,7 @@ class LaravelRequestDocsToOpenApi
     private array $openApi = [];
 
     /**
-     * @param  \Rakutentech\LaravelRequestDocs\Doc[]  $docs
+     * @param \Rakutentech\LaravelRequestDocs\Doc[] $docs
      * @return $this
      */
     public function openApi(array $docs): LaravelRequestDocsToOpenApi
@@ -28,14 +28,14 @@ public function openApi(array $docs): LaravelRequestDocsToOpenApi
     }
 
     /**
-     * @param  \Rakutentech\LaravelRequestDocs\Doc[]  $docs
+     * @param \Rakutentech\LaravelRequestDocs\Doc[] $docs
      * @return void
      */
     private function docsToOpenApi(array $docs): void
     {
         $this->openApi['paths'] = [];
         $deleteWithBody         = config('request-docs.open_api.delete_with_body', false);
-        $excludeHttpMethods     = array_map(fn ($item) => strtolower($item), config('request-docs.open_api.exclude_http_methods', []));
+        $excludeHttpMethods     = array_map(fn($item) => strtolower($item), config('request-docs.open_api.exclude_http_methods', []));
 
         foreach ($docs as $doc) {
             $httpMethod = strtolower($doc->getHttpMethod());
@@ -91,6 +91,7 @@ private function docsToOpenApi(array $docs): void
             }
         }
     }
+
     protected function setAndFilterResponses(Doc $doc): array
     {
         $docResponses    = $doc->getResponses();
@@ -116,12 +117,12 @@ protected function makeQueryParameterItem(string $attribute, $rule): array
             $rule = implode('|', $rule);
         }
         $parameter = [
-            'name'        => $attribute,
+            'name' => $attribute,
             'description' => $rule,
-            'in'          => 'query',
-            'style'       => 'form',
-            'required'    => str_contains($rule, 'required'),
-            'schema'      => [
+            'in' => 'query',
+            'style' => 'form',
+            'required' => str_contains($rule, 'required'),
+            'schema' => [
                 'type' => $this->getAttributeType($rule),
             ],
         ];
@@ -135,12 +136,12 @@ protected function makePathParameterItem(string $attribute, $rule): array
         }
 
         $parameter = [
-            'name'        => $attribute,
+            'name' => $attribute,
             'description' => $rule,
-            'in'          => 'path',
-            'style'       => 'simple',
-            'required'    => str_contains($rule, 'required'),
-            'schema'      => [
+            'in' => 'path',
+            'style' => 'simple',
+            'required' => str_contains($rule, 'required'),
+            'schema' => [
                 'type' => $this->getAttributeType($rule),
             ],
         ];
@@ -151,10 +152,10 @@ protected function makeRequestBodyItem(string $contentType): array
     {
         $requestBody = [
             'description' => "Request body",
-            'content'     => [
+            'content' => [
                 $contentType => [
                     'schema' => [
-                        'type'       => 'object',
+                        'type' => 'object',
                         'properties' => [],
                     ],
                 ],
@@ -168,9 +169,9 @@ protected function makeRequestBodyContentPropertyItem(string $rule): array
         $type = $this->getAttributeType($rule);
 
         return [
-            'type'     => $type,
+            'type' => $type,
             'nullable' => str_contains($rule, 'nullable'),
-            'format'   => $this->attributeIsFile($rule) ? 'binary' : $type,
+            'format' => $this->attributeIsFile($rule) ? 'binary' : $type,
         ];
     }
 
@@ -203,6 +204,7 @@ protected function appendGlobalSecurityScheme(): void
             case 'bearer':
                 $this->openApi['components']['securitySchemes']['bearerAuth'] = [
                     'type' => 'http',
+                    'name' => config('request-docs.open_api.security.name', 'Bearer Authorization Token'),
                     'scheme' => 'bearer'
                 ];
                 $this->openApi['security'][]                                  = [
@@ -213,6 +215,7 @@ protected function appendGlobalSecurityScheme(): void
             case 'basic':
                 $this->openApi['components']['securitySchemes']['basicAuth'] = [
                     'type' => 'http',
+                    'name' => config('request-docs.open_api.security.name', 'Basic Authorization Username and Password'),
                     'scheme' => 'basic'
                 ];
                 $this->openApi['security'][]                                 = [
@@ -223,16 +226,30 @@ protected function appendGlobalSecurityScheme(): void
             case 'apikey':
                 $this->openApi['components']['securitySchemes']['apiKeyAuth'] = [
                     'type' => 'apiKey',
-                    'name' => config('request-docs.open_api.security.key_name', 'api_key'),
+                    'name' => config('request-docs.open_api.security.name', 'api_key'),
                     'in' => config('request-docs.open_api.security.position', 'header')
                 ];
                 $this->openApi['security'][]                                  = ['apiKeyAuth' => []];
                 break;
 
+            case 'jwt':
+                $this->openApi['components']['securitySchemes']['bearerAuth'] = [
+                    'type' => 'http',
+                    'scheme' => 'bearer',
+                    'name' => config('request-docs.open_api.security.name', 'Bearer Authorization Token'),
+                    'in' => config('request-docs.open_api.security.position', 'header'),
+                    'bearerFormat' => 'JWT'
+                ];
+                $this->openApi['security'][]                                  = [
+                    'bearerAuth' => []
+                ];
+                break;
+
             default:
                 break;
         }
     }
+
     /**
      * @codeCoverageIgnore
      */