NelmioApiDocBundle/Describer/DefaultDescriber.php

<?php

/*
 * This file is part of the ApiDocBundle package.
 *
 * (c) EXSyst
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace EXSyst\Bundle\ApiDocBundle\Describer;

use EXSyst\Component\Swagger\Swagger;

/**
 * Makes the swagger documentation valid even if there are missing fields.
 *
 * @author Ener-Getick <egetick@gmail.com>
 */
class DefaultDescriber implements DescriberInterface
{
    public function describe(Swagger $api)
    {
        // Info
        $info = $api->getInfo();
        if (null === $info->getTitle()) {
            $info->setTitle('');
        }
        if (null === $info->getVersion()) {
            $info->setVersion('0.0.0');
        }

        // Paths
        $paths = $api->getPaths();
        foreach ($paths as $uri => $path) {
            // Path Parameters
            preg_match_all('/\{(.+)\}/SU', $uri, $matches);
            $pathParameters = $matches[1];

            foreach ($path->getMethods() as $method) {
                $operation = $path->getOperation($method);
                $parameters = $operation->getParameters();

                // Default Path Parameters
                foreach ($pathParameters as $pathParameter) {
                    if ($parameters->has($pathParameter, 'path')) {
                        continue;
                    }

                    $parameters->get($pathParameter, 'path')
                        ->setRequired(true)
                        ->setType('string');
                }

                // Default Response
                if (0 === iterator_count($operation->getResponses())) {
                    $defaultResponse = $operation->getResponses()->get('default');
                    $defaultResponse->setDescription('');
                }
            }
        }
    }
}