openapi3 delete method exclude request body configuration added

Author: hafijul233

config/request-docs.php

@@ -66,7 +66,9 @@
         'license' => 'Apache 2.0',
         'license_url' => 'https://www.apache.org/licenses/LICENSE-2.0.html',
         'server_url' => env('APP_URL', 'http://localhost'),
-
+        //openapi 3.0.x doesn't support request body for develop operation
+        //ref: https://github.com/OAI/OpenAPI-Specification/pull/2117
+        'include_body_on_delete' => false,
         // for now putting default responses for all. This can be changed later based on specific needs
         'responses' => [
             '200' => [

src/LaravelRequestDocsToOpenApi.php

@@ -33,7 +33,7 @@ public function openApi(array $docs): LaravelRequestDocsToOpenApi
     private function docsToOpenApi(array $docs): void
     {
         $this->openApi['paths'] = [];
-//        dd($docs);
+        $includeBodyForDelete = config('request-docs.open_api.include_body_on_delete');
         foreach ($docs as $doc) {
             $requestHasFile  = false;
             $httpMethod      = strtolower($doc->getHttpMethod());
@@ -66,7 +66,7 @@ private function docsToOpenApi(array $docs): void
 
             $contentType = $requestHasFile ? 'multipart/form-data' : 'application/json';
 
-            if ($isPost || $isPut || $isDelete) {
+            if ($isPost || $isPut || ($isDelete && $includeBodyForDelete)) {
                 $this->openApi['paths'][$uriLeadingSlash][$httpMethod]['requestBody'] = $this->makeRequestBodyItem($contentType);
             }
 
@@ -76,7 +76,7 @@ private function docsToOpenApi(array $docs): void
                         $parameter                                                             = $this->makeQueryParameterItem($attribute, $rule);
                         $this->openApi['paths'][$uriLeadingSlash][$httpMethod]['parameters'][] = $parameter;
                     }
-                    if ($isPost || $isPut || $isDelete) {
+                    if ($isPost || $isPut || ($isDelete && $includeBodyForDelete)) {
                         $this->openApi['paths'][$uriLeadingSlash][$httpMethod]['requestBody']['content'][$contentType]['schema']['properties'][$attribute] = $this->makeRequestBodyContentPropertyItem($rule);
                     }
                 }