@@ -18,7 +18,7 @@ |
||
18 | 18 | Route::prefix($path) |
19 | 19 | ->namespace('\Mpociot\ApiDoc\Http') |
20 | 20 | ->middleware(static::middleware()) |
21 | - ->group(function () { |
|
21 | + ->group(function() { |
|
22 | 22 | Route::get('/', 'Controller@html')->name('apidoc'); |
23 | 23 | Route::get('.json', 'Controller@json')->name('apidoc.json'); |
24 | 24 | }); |
@@ -7,7 +7,7 @@ |
||
7 | 7 | |
8 | 8 | Route::namespace('\Mpociot\ApiDoc\Http') |
9 | 9 | ->middleware($middleware) |
10 | - ->group(function () use ($prefix) { |
|
10 | + ->group(function() use ($prefix) { |
|
11 | 11 | Route::get($prefix, 'Controller@html')->name('apidoc'); |
12 | 12 | Route::get("$prefix.json", 'Controller@json')->name('apidoc.json'); |
13 | 13 | }); |
@@ -53,7 +53,7 @@ discard block |
||
53 | 53 | 'description' => config('apidoc.postman.description') ?: '', |
54 | 54 | 'schema' => 'https://schema.getpostman.com/json/collection/v2.0.0/collection.json', |
55 | 55 | ], |
56 | - 'item' => $this->routeGroups->map(function (Collection $routes, $groupName) { |
|
56 | + 'item' => $this->routeGroups->map(function(Collection $routes, $groupName) { |
|
57 | 57 | return [ |
58 | 58 | 'name' => $groupName, |
59 | 59 | 'description' => $routes->first()['metadata']['groupDescription'], |
@@ -62,7 +62,7 @@ discard block |
||
62 | 62 | })->values()->toArray(), |
63 | 63 | ]; |
64 | 64 | |
65 | - if (! empty($this->auth)) { |
|
65 | + if (!empty($this->auth)) { |
|
66 | 66 | $collection['auth'] = $this->auth; |
67 | 67 | } |
68 | 68 | |
@@ -97,7 +97,7 @@ discard block |
||
97 | 97 | |
98 | 98 | // Exclude authentication headers if they're handled by Postman auth |
99 | 99 | $authHeader = $this->getAuthHeader(); |
100 | - if (! empty($authHeader)) { |
|
100 | + if (!empty($authHeader)) { |
|
101 | 101 | $headers = $headers->except($authHeader); |
102 | 102 | } |
103 | 103 | |
@@ -105,7 +105,7 @@ discard block |
||
105 | 105 | ->union([ |
106 | 106 | 'Accept' => 'application/json', |
107 | 107 | ]) |
108 | - ->map(function ($value, $header) { |
|
108 | + ->map(function($value, $header) { |
|
109 | 109 | return [ |
110 | 110 | 'key' => $header, |
111 | 111 | 'value' => $value, |
@@ -119,7 +119,7 @@ discard block |
||
119 | 119 | { |
120 | 120 | // URL Parameters are collected by the `UrlParameters` strategies, but only make sense if they're in the route |
121 | 121 | // definition. Filter out any URL parameters that don't appear in the URL. |
122 | - $urlParams = collect($route['urlParameters'])->filter(function ($_, $key) use ($route) { |
|
122 | + $urlParams = collect($route['urlParameters'])->filter(function($_, $key) use ($route) { |
|
123 | 123 | return Str::contains($route['uri'], '{' . $key . '}'); |
124 | 124 | }); |
125 | 125 | |
@@ -128,16 +128,16 @@ discard block |
||
128 | 128 | 'protocol' => $this->protocol, |
129 | 129 | 'host' => $this->baseUrl, |
130 | 130 | // Substitute laravel/symfony query params ({example}) to Postman style, prefixed with a colon |
131 | - 'path' => preg_replace_callback('/\/{(\w+)\??}(?=\/|$)/', function ($matches) { |
|
131 | + 'path' => preg_replace_callback('/\/{(\w+)\??}(?=\/|$)/', function($matches) { |
|
132 | 132 | return '/:' . $matches[1]; |
133 | 133 | }, $route['uri']), |
134 | - 'query' => collect($route['queryParameters'])->map(function ($parameter, $key) { |
|
134 | + 'query' => collect($route['queryParameters'])->map(function($parameter, $key) { |
|
135 | 135 | return [ |
136 | 136 | 'key' => $key, |
137 | 137 | 'value' => urlencode($parameter['value']), |
138 | 138 | 'description' => $parameter['description'], |
139 | 139 | // Default query params to disabled if they aren't required and have empty values |
140 | - 'disabled' => ! $parameter['required'] && empty($parameter['value']), |
|
140 | + 'disabled' => !$parameter['required'] && empty($parameter['value']), |
|
141 | 141 | ]; |
142 | 142 | })->values()->toArray(), |
143 | 143 | ]; |
@@ -148,7 +148,7 @@ discard block |
||
148 | 148 | return $base; |
149 | 149 | } |
150 | 150 | |
151 | - $base['variable'] = $urlParams->map(function ($parameter, $key) { |
|
151 | + $base['variable'] = $urlParams->map(function($parameter, $key) { |
|
152 | 152 | return [ |
153 | 153 | 'id' => $key, |
154 | 154 | 'key' => $key, |
@@ -163,7 +163,7 @@ discard block |
||
163 | 163 | protected function getAuthHeader() |
164 | 164 | { |
165 | 165 | $auth = $this->auth; |
166 | - if (empty($auth) || ! is_string($auth['type'] ?? null)) { |
|
166 | + if (empty($auth) || !is_string($auth['type'] ?? null)) { |
|
167 | 167 | return null; |
168 | 168 | } |
169 | 169 |
@@ -31,7 +31,7 @@ discard block |
||
31 | 31 | public function __invoke(Route $route, \ReflectionClass $controller, \ReflectionMethod $method, array $routeRules, array $context = []) |
32 | 32 | { |
33 | 33 | $rulesToApply = $routeRules['response_calls'] ?? []; |
34 | - if (! $this->shouldMakeApiCall($route, $rulesToApply, $context)) { |
|
34 | + if (!$this->shouldMakeApiCall($route, $rulesToApply, $context)) { |
|
35 | 35 | return null; |
36 | 36 | } |
37 | 37 | |
@@ -194,14 +194,14 @@ discard block |
||
194 | 194 | // set URL and query parameters |
195 | 195 | $uri = $request->getRequestUri(); |
196 | 196 | $query = $request->getQueryString(); |
197 | - if (! empty($query)) { |
|
197 | + if (!empty($query)) { |
|
198 | 198 | $uri .= "?$query"; |
199 | 199 | } |
200 | 200 | $response = call_user_func_array([$dispatcher, strtolower($request->method())], [$uri]); |
201 | 201 | |
202 | 202 | // the response from the Dingo dispatcher is the 'raw' response from the controller, |
203 | 203 | // so we have to ensure it's JSON first |
204 | - if (! $response instanceof Response) { |
|
204 | + if (!$response instanceof Response) { |
|
205 | 205 | $response = response()->json($response); |
206 | 206 | } |
207 | 207 | |
@@ -329,7 +329,7 @@ discard block |
||
329 | 329 | } |
330 | 330 | |
331 | 331 | // Don't attempt a response call if there are already successful responses |
332 | - $successResponses = collect($context['responses'])->filter(function ($response) { |
|
332 | + $successResponses = collect($context['responses'])->filter(function($response) { |
|
333 | 333 | return ((string) $response['status'])[0] == '2'; |
334 | 334 | })->count(); |
335 | 335 | if ($successResponses) { |
@@ -365,7 +365,7 @@ discard block |
||
365 | 365 | $prefix = 'HTTP_'; |
366 | 366 | foreach ($headers as $name => $value) { |
367 | 367 | $name = strtr(strtoupper($name), '-', '_'); |
368 | - if (! Str::startsWith($name, $prefix) && $name !== 'CONTENT_TYPE') { |
|
368 | + if (!Str::startsWith($name, $prefix) && $name !== 'CONTENT_TYPE') { |
|
369 | 369 | $name = $prefix . $name; |
370 | 370 | } |
371 | 371 | $server[$name] = $value; |
@@ -44,7 +44,7 @@ discard block |
||
44 | 44 | { |
45 | 45 | // Avoid "holes" in the keys of the filtered array, by using array_values on the filtered array |
46 | 46 | $responseFileTags = array_values( |
47 | - array_filter($tags, function ($tag) { |
|
47 | + array_filter($tags, function($tag) { |
|
48 | 48 | return $tag instanceof Tag && strtolower($tag->getName()) === 'responsefile'; |
49 | 49 | }) |
50 | 50 | ); |
@@ -53,16 +53,16 @@ discard block |
||
53 | 53 | return null; |
54 | 54 | } |
55 | 55 | |
56 | - $responses = array_map(function (Tag $responseFileTag) { |
|
56 | + $responses = array_map(function(Tag $responseFileTag) { |
|
57 | 57 | preg_match('/^(\d{3})?\s?([\S]*[\s]*?)(\{.*\})?$/', $responseFileTag->getContent(), $result); |
58 | 58 | $relativeFilePath = trim($result[2]); |
59 | 59 | $filePath = storage_path($relativeFilePath); |
60 | - if (! file_exists($filePath)) { |
|
60 | + if (!file_exists($filePath)) { |
|
61 | 61 | throw new \Exception('@responseFile ' . $relativeFilePath . ' does not exist'); |
62 | 62 | } |
63 | 63 | $status = $result[1] ?: 200; |
64 | 64 | $content = $result[2] ? file_get_contents($filePath, true) : '{}'; |
65 | - $json = ! empty($result[3]) ? str_replace("'", '"', $result[3]) : '{}'; |
|
65 | + $json = !empty($result[3]) ? str_replace("'", '"', $result[3]) : '{}'; |
|
66 | 66 | $merged = array_merge(json_decode($content, true), json_decode($json, true)); |
67 | 67 | |
68 | 68 | return ['content' => json_encode($merged), 'status' => (int) $status]; |
@@ -15,7 +15,7 @@ |
||
15 | 15 | public function handle() |
16 | 16 | { |
17 | 17 | $sourceOutputPath = 'resources/docs/source'; |
18 | - if (! is_dir($sourceOutputPath)) { |
|
18 | + if (!is_dir($sourceOutputPath)) { |
|
19 | 19 | $this->error('There is no existing documentation available at ' . $sourceOutputPath . '.'); |
20 | 20 | |
21 | 21 | return false; |
@@ -83,7 +83,7 @@ discard block |
||
83 | 83 | |
84 | 84 | $responses = $this->fetchResponses($controller, $method, $route, $routeRules, $parsedRoute); |
85 | 85 | $parsedRoute['responses'] = $responses; |
86 | - $parsedRoute['showresponse'] = ! empty($responses); |
|
86 | + $parsedRoute['showresponse'] = !empty($responses); |
|
87 | 87 | |
88 | 88 | return $parsedRoute; |
89 | 89 | } |
@@ -120,7 +120,7 @@ discard block |
||
120 | 120 | { |
121 | 121 | $responses = $this->iterateThroughStrategies('responses', $context, [$route, $controller, $method, $rulesToApply]); |
122 | 122 | if (count($responses)) { |
123 | - return array_filter($responses, function ($response) { |
|
123 | + return array_filter($responses, function($response) { |
|
124 | 124 | return $response['content'] != null; |
125 | 125 | }); |
126 | 126 | } |
@@ -170,7 +170,7 @@ discard block |
||
170 | 170 | $strategyArgs = $arguments; |
171 | 171 | $strategyArgs[] = $context; |
172 | 172 | $results = $strategy(...$strategyArgs); |
173 | - if (! is_null($results)) { |
|
173 | + if (!is_null($results)) { |
|
174 | 174 | foreach ($results as $index => $item) { |
175 | 175 | if ($stage == 'responses') { |
176 | 176 | // Responses are additive |
@@ -182,7 +182,7 @@ discard block |
||
182 | 182 | // and also allows values to be overwritten |
183 | 183 | |
184 | 184 | // Don't allow overwriting if an empty value is trying to replace a set one |
185 | - if (! in_array($context[$stage], [null, ''], true) && in_array($item, [null, ''], true)) { |
|
185 | + if (!in_array($context[$stage], [null, ''], true) && in_array($item, [null, ''], true)) { |
|
186 | 186 | continue; |
187 | 187 | } else { |
188 | 188 | $context[$stage][$index] = $item; |
@@ -207,8 +207,8 @@ discard block |
||
207 | 207 | $values = []; |
208 | 208 | |
209 | 209 | // Remove params which have no examples. |
210 | - $params = array_filter($params, function ($details) { |
|
211 | - return ! is_null($details['value']); |
|
210 | + $params = array_filter($params, function($details) { |
|
211 | + return !is_null($details['value']); |
|
212 | 212 | }); |
213 | 213 | |
214 | 214 | foreach ($params as $paramName => $details) { |
@@ -239,6 +239,6 @@ discard block |
||
239 | 239 | $paramName = str_replace(['][', '[', ']', '..'], ['.', '.', '', '.*.'], $paramName); |
240 | 240 | } |
241 | 241 | // Then generate a sample item for the dot notation |
242 | - Arr::set($values, str_replace(['.*', '*.'], ['.0','0.'], $paramName), $paramExample); |
|
242 | + Arr::set($values, str_replace(['.*', '*.'], ['.0', '0.'], $paramName), $paramExample); |
|
243 | 243 | } |
244 | 244 | } |
@@ -26,7 +26,7 @@ discard block |
||
26 | 26 | 'groupDescription' => $routeGroupDescription, |
27 | 27 | 'title' => $routeTitle ?: $methodDocBlock->getShortDescription(), |
28 | 28 | 'description' => $methodDocBlock->getLongDescription()->getContents(), |
29 | - 'authenticated' => $this->getAuthStatusFromDocBlock($classDocBlock->getTags())?:$this->getAuthStatusFromDocBlock($methodDocBlock->getTags()), |
|
29 | + 'authenticated' => $this->getAuthStatusFromDocBlock($classDocBlock->getTags()) ?: $this->getAuthStatusFromDocBlock($methodDocBlock->getTags()), |
|
30 | 30 | ]; |
31 | 31 | } |
32 | 32 | |
@@ -38,7 +38,7 @@ discard block |
||
38 | 38 | protected function getAuthStatusFromDocBlock(array $tags) |
39 | 39 | { |
40 | 40 | $authTag = collect($tags) |
41 | - ->first(function ($tag) { |
|
41 | + ->first(function($tag) { |
|
42 | 42 | return $tag instanceof Tag && strtolower($tag->getName()) === 'authenticated'; |
43 | 43 | }); |
44 | 44 | |
@@ -54,7 +54,7 @@ discard block |
||
54 | 54 | protected function getRouteGroupDescriptionAndTitle(DocBlock $methodDocBlock, DocBlock $controllerDocBlock) |
55 | 55 | { |
56 | 56 | // @group tag on the method overrides that on the controller |
57 | - if (! empty($methodDocBlock->getTags())) { |
|
57 | + if (!empty($methodDocBlock->getTags())) { |
|
58 | 58 | foreach ($methodDocBlock->getTags() as $tag) { |
59 | 59 | if ($tag->getName() === 'group') { |
60 | 60 | $routeGroupParts = explode("\n", trim($tag->getContent())); |
@@ -12,7 +12,7 @@ |
||
12 | 12 | /* |
13 | 13 | * Static output folder: HTML documentation and assets will be generated in this folder. |
14 | 14 | */ |
15 | - 'output_folder' => 'public/docs', |
|
15 | + 'output_folder' => 'public/docs', |
|
16 | 16 | |
17 | 17 | /* |
18 | 18 | * Settings for `laravel` type output. |