mirror of
https://github.com/retailcrm/NelmioApiDocBundle.git
synced 2025-02-02 23:59:26 +03:00
14383f4ee5
* add zircore/swagger-php v4 to composer.json * fix incompatibilities * add compatibility with 3.2 * Apply fixes from StyleCI * mark SetsContextTrait as internal * Bump php version Co-authored-by: Alexey <alshenestky@icloud.com> Co-authored-by: Alexey Alshenetsky <alshenetsky@users.noreply.github.com> Co-authored-by: Guilhem Niot <guilhem@gniot.fr>
54 lines
1.6 KiB
PHP
54 lines
1.6 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;
|
|
use OpenApi\Generator;
|
|
|
|
/**
|
|
* 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 (Generator::UNDEFINED === $info->title) {
|
|
$info->title = '';
|
|
}
|
|
if (Generator::UNDEFINED === $info->version) {
|
|
$info->version = '0.0.0';
|
|
}
|
|
|
|
// Paths
|
|
if (Generator::UNDEFINED === $api->paths) {
|
|
$api->paths = [];
|
|
}
|
|
foreach ($api->paths as $path) {
|
|
foreach (Util::OPERATIONS as $method) {
|
|
/** @var OA\Operation $operation */
|
|
$operation = $path->{$method};
|
|
if (Generator::UNDEFINED !== $operation && null !== $operation && (Generator::UNDEFINED === $operation->responses || empty($operation->responses))) {
|
|
/** @var OA\Response $response */
|
|
$response = Util::getIndexedCollectionItem($operation, OA\Response::class, 'default');
|
|
$response->description = '';
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|