mirror of
https://github.com/retailcrm/NelmioApiDocBundle.git
synced 2025-02-02 15:51:48 +03:00
7d9573ddf6
* Move the OpenApi processing to ApiDocGenerator * Temporary fix for https://github.com/zircote/swagger-php/pull/791 * Stop using the ModelRegistry in OpenApiPhpDescriber
53 lines
1.5 KiB
PHP
53 lines
1.5 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of the NelmioApiDocBundle package.
|
|
*
|
|
* (c) Nelmio
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Nelmio\ApiDocBundle\Describer;
|
|
|
|
use Nelmio\ApiDocBundle\OpenApiPhp\Util;
|
|
use OpenApi\Annotations as OA;
|
|
|
|
/**
|
|
* Makes the swagger documentation valid even if there are missing fields.
|
|
*
|
|
* @author Ener-Getick <egetick@gmail.com>
|
|
*/
|
|
final class DefaultDescriber implements DescriberInterface
|
|
{
|
|
public function describe(OA\OpenApi $api)
|
|
{
|
|
// Info
|
|
/** @var OA\Info $info */
|
|
$info = Util::getChild($api, OA\Info::class);
|
|
if (OA\UNDEFINED === $info->title) {
|
|
$info->title = '';
|
|
}
|
|
if (OA\UNDEFINED === $info->version) {
|
|
$info->version = '0.0.0';
|
|
}
|
|
|
|
// Paths
|
|
if (OA\UNDEFINED === $api->paths) {
|
|
$api->paths = [];
|
|
}
|
|
foreach ($api->paths as $path) {
|
|
foreach (Util::OPERATIONS as $method) {
|
|
/** @var OA\Operation $operation */
|
|
$operation = $path->{$method};
|
|
if (OA\UNDEFINED !== $operation && null !== $operation && (OA\UNDEFINED === $operation->responses || empty($operation->responses))) {
|
|
/** @var OA\Response $response */
|
|
$response = Util::getIndexedCollectionItem($operation, OA\Response::class, 'default');
|
|
$response->description = '';
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|