vendor/api-platform/core/src/Bridge/Symfony/Bundle/Action/SwaggerUiAction.php line 36

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the API Platform project.
  5.  *
  6.  * (c) Kévin Dunglas <dunglas@gmail.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. declare(strict_types=1);
  14. namespace ApiPlatform\Core\Bridge\Symfony\Bundle\Action;
  16. use ApiPlatform\Core\Api\FormatsProviderInterface;
  17. use ApiPlatform\Core\Bridge\Symfony\Bundle\SwaggerUi\SwaggerUiAction as OpenApiSwaggerUiAction;
  18. use ApiPlatform\Core\Documentation\Documentation;
  19. use ApiPlatform\Core\Exception\RuntimeException;
  20. use ApiPlatform\Core\Metadata\Resource\Factory\ResourceMetadataFactoryInterface;
  21. use ApiPlatform\Core\Metadata\Resource\Factory\ResourceNameCollectionFactoryInterface;
  22. use ApiPlatform\Core\Util\RequestAttributesExtractor;
  23. use Symfony\Component\HttpFoundation\Request;
  24. use Symfony\Component\HttpFoundation\Response;
  25. use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
  26. use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
  27. use Twig\Environment as TwigEnvironment;
  29. /**
  30.  * Displays the documentation.
  31.  *
  32.  * @deprecated please refer to ApiPlatform\Core\Bridge\Symfony\Bundle\SwaggerUi\SwaggerUiAction for further changes
  33.  *
  34.  * @author Kévin Dunglas <dunglas@gmail.com>
  35.  */
  36. final class SwaggerUiAction
  37. {
  38.     private $resourceNameCollectionFactory;
  39.     private $resourceMetadataFactory;
  40.     private $normalizer;
  41.     private $twig;
  42.     private $urlGenerator;
  43.     private $title;
  44.     private $description;
  45.     private $version;
  46.     private $showWebby;
  47.     private $formats;
  48.     private $oauthEnabled;
  49.     private $oauthClientId;
  50.     private $oauthClientSecret;
  51.     private $oauthType;
  52.     private $oauthFlow;
  53.     private $oauthTokenUrl;
  54.     private $oauthAuthorizationUrl;
  55.     private $oauthScopes;
  56.     private $formatsProvider;
  57.     private $swaggerUiEnabled;
  58.     private $reDocEnabled;
  59.     private $graphqlEnabled;
  60.     private $graphiQlEnabled;
  61.     private $graphQlPlaygroundEnabled;
  62.     private $swaggerVersions;
  63.     private $swaggerUiAction;
  64.     private $assetPackage;
  66.     /**
  67.      * @param int[]      $swaggerVersions
  68.      * @param mixed|null $assetPackage
  69.      */
  70.     public function __construct(ResourceNameCollectionFactoryInterface $resourceNameCollectionFactory, ResourceMetadataFactoryInterface $resourceMetadataFactory, NormalizerInterface $normalizer, TwigEnvironment $twig, UrlGeneratorInterface $urlGenerator, string $title = '', string $description = '', string $version = '', $formats = [], $oauthEnabled = false, $oauthClientId = '', $oauthClientSecret = '', $oauthType = '', $oauthFlow = '', $oauthTokenUrl = '', $oauthAuthorizationUrl = '', $oauthScopes = [], bool $showWebby = true, bool $swaggerUiEnabled = false, bool $reDocEnabled = false, bool $graphqlEnabled = false, bool $graphiQlEnabled = false, bool $graphQlPlaygroundEnabled = false, array $swaggerVersions = [2, 3], OpenApiSwaggerUiAction $swaggerUiAction = null, $assetPackage = null)
  71.     {
  72.         $this->resourceNameCollectionFactory = $resourceNameCollectionFactory;
  73.         $this->resourceMetadataFactory = $resourceMetadataFactory;
  74.         $this->normalizer = $normalizer;
  75.         $this->twig = $twig;
  76.         $this->urlGenerator = $urlGenerator;
  77.         $this->title = $title;
  78.         $this->showWebby = $showWebby;
  79.         $this->description = $description;
  80.         $this->version = $version;
  81.         $this->oauthEnabled = $oauthEnabled;
  82.         $this->oauthClientId = $oauthClientId;
  83.         $this->oauthClientSecret = $oauthClientSecret;
  84.         $this->oauthType = $oauthType;
  85.         $this->oauthFlow = $oauthFlow;
  86.         $this->oauthTokenUrl = $oauthTokenUrl;
  87.         $this->oauthAuthorizationUrl = $oauthAuthorizationUrl;
  88.         $this->oauthScopes = $oauthScopes;
  89.         $this->swaggerUiEnabled = $swaggerUiEnabled;
  90.         $this->reDocEnabled = $reDocEnabled;
  91.         $this->graphqlEnabled = $graphqlEnabled;
  92.         $this->graphiQlEnabled = $graphiQlEnabled;
  93.         $this->graphQlPlaygroundEnabled = $graphQlPlaygroundEnabled;
  94.         $this->swaggerVersions = $swaggerVersions;
  95.         $this->swaggerUiAction = $swaggerUiAction;
  96.         $this->assetPackage = $assetPackage;
  98.         if (null === $this->swaggerUiAction) {
  99.             @trigger_error(sprintf('The use of "%s" is deprecated since API Platform 2.6, use "%s" instead.', __CLASS__, OpenApiSwaggerUiAction::class), \E_USER_DEPRECATED);
  100.         }
  102.         if (\is_array($formats)) {
  103.             $this->formats = $formats;
  105.             return;
  106.         }
  108.         @trigger_error(sprintf('Passing an array or an instance of "%s" as 5th parameter of the constructor of "%s" is deprecated since API Platform 2.5, pass an array instead', FormatsProviderInterface::class, __CLASS__), \E_USER_DEPRECATED);
  109.         $this->formatsProvider = $formats;
  110.     }
  112.     public function __invoke(Request $request)
  113.     {
  114.         if ($this->swaggerUiAction) {
  115.             return $this->swaggerUiAction->__invoke($request);
  116.         }
  118.         $attributes = RequestAttributesExtractor::extractAttributes($request);
  120.         // BC check to be removed in 3.0
  121.         if (null === $this->formatsProvider) {
  122.             $formats = $attributes ? $this
  123.                 ->resourceMetadataFactory
  124.                 ->create($attributes['resource_class'])
  125.                 ->getOperationAttribute($attributes, 'output_formats', [], true) : $this->formats;
  126.         } else {
  127.             $formats = $this->formatsProvider->getFormatsFromAttributes($attributes);
  128.         }
  130.         $documentation = new Documentation($this->resourceNameCollectionFactory->create(), $this->title, $this->description, $this->version);
  132.         return new Response($this->twig->render('@ApiPlatform/SwaggerUi/index.html.twig', $this->getContext($request, $documentation) + ['formats' => $formats]));
  133.     }
  135.     /**
  136.      * Gets the base Twig context.
  137.      */
  138.     private function getContext(Request $request, Documentation $documentation): array
  139.     {
  140.         $context = [
  141.             'title' => $this->title,
  142.             'description' => $this->description,
  143.             'showWebby' => $this->showWebby,
  144.             'swaggerUiEnabled' => $this->swaggerUiEnabled,
  145.             'reDocEnabled' => $this->reDocEnabled,
  146.             'graphqlEnabled' => $this->graphqlEnabled,
  147.             'graphiQlEnabled' => $this->graphiQlEnabled,
  148.             'graphQlPlaygroundEnabled' => $this->graphQlPlaygroundEnabled,
  149.             'assetPackage' => $this->assetPackage,
  150.         ];
  152.         $swaggerContext = ['spec_version' => $request->query->getInt('spec_version', $this->swaggerVersions[0] ?? 2)];
  153.         if ('' !== $baseUrl = $request->getBaseUrl()) {
  154.             $swaggerContext['base_url'] = $baseUrl;
  155.         }
  157.         $swaggerData = [
  158.             'url' => $this->urlGenerator->generate('api_doc', ['format' => 'json']),
  159.             'spec' => $this->normalizer->normalize($documentation, 'json', $swaggerContext),
  160.         ];
  162.         $swaggerData['oauth'] = [
  163.             'enabled' => $this->oauthEnabled,
  164.             'clientId' => $this->oauthClientId,
  165.             'clientSecret' => $this->oauthClientSecret,
  166.             'type' => $this->oauthType,
  167.             'flow' => $this->oauthFlow,
  168.             'tokenUrl' => $this->oauthTokenUrl,
  169.             'authorizationUrl' => $this->oauthAuthorizationUrl,
  170.             'scopes' => $this->oauthScopes,
  171.         ];
  173.         if ($request->isMethodSafe() && null !== $resourceClass = $request->attributes->get('_api_resource_class')) {
  174.             $swaggerData['id'] = $request->attributes->get('id');
  175.             $swaggerData['queryParameters'] = $request->query->all();
  177.             $metadata = $this->resourceMetadataFactory->create($resourceClass);
  178.             $swaggerData['shortName'] = $metadata->getShortName();
  180.             if (null !== $collectionOperationName = $request->attributes->get('_api_collection_operation_name')) {
  181.                 $swaggerData['operationId'] = sprintf('%s%sCollection', $collectionOperationName, ucfirst($swaggerData['shortName']));
  182.             } elseif (null !== $itemOperationName = $request->attributes->get('_api_item_operation_name')) {
  183.                 $swaggerData['operationId'] = sprintf('%s%sItem', $itemOperationName, ucfirst($swaggerData['shortName']));
  184.             } elseif (null !== $subresourceOperationContext = $request->attributes->get('_api_subresource_context')) {
  185.                 $swaggerData['operationId'] = $subresourceOperationContext['operationId'];
  186.             }
  188.             [$swaggerData['path'], $swaggerData['method']] = $this->getPathAndMethod($swaggerData);
  189.         }
  191.         return $context + ['swagger_data' => $swaggerData];
  192.     }
  194.     private function getPathAndMethod(array $swaggerData): array
  195.     {
  196.         foreach ($swaggerData['spec']['paths'] as $path => $operations) {
  197.             foreach ($operations as $method => $operation) {
  198.                 if ($operation['operationId'] === $swaggerData['operationId']) {
  199.                     return [$path, $method];
  200.                 }
  201.             }
  202.         }
  204.         throw new RuntimeException(sprintf('The operation "%s" cannot be found in the Swagger specification.', $swaggerData['operationId']));
  205.     }
  206. }