vendor/api-platform/core/src/Metadata/Resource/DeprecationMetadataTrait.php line 50

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\Metadata\Resource;
  16. use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
  18. /**
  19.  * @internal
  20.  */
  21. trait DeprecationMetadataTrait
  22. {
  23.     private $camelCaseToSnakeCaseNameConverter;
  25.     public function getKeyValue(string $key, $value)
  26.     {
  27.         if (!$this->camelCaseToSnakeCaseNameConverter) {
  28.             $this->camelCaseToSnakeCaseNameConverter = new CamelCaseToSnakeCaseNameConverter();
  29.         }
  31.         if ('attributes' === $key) {
  32.             trigger_deprecation('api-platform/core', '2.7', 'The "attributes" option is deprecated and will be renamed to "extra_properties".');
  33.             $key = 'extra_properties';
  34.         } elseif ('iri' === $key) {
  35.             trigger_deprecation('api-platform/core', '2.7', 'The "iri" is deprecated and will be renamed to "types".');
  36.             $key = 'types';
  37.             $value = [$value];
  38.         } elseif ('validation_groups' === $key) {
  39.             trigger_deprecation('api-platform/core', '2.7', 'The "validation_groups" is deprecated and will be renamed to "validation_context" having an array with a "groups" key.');
  40.             $key = 'validation_context';
  41.             $value = ['groups' => $value];
  42.         } elseif ('access_control' === $key) {
  43.             $key = 'security';
  44.             trigger_deprecation('api-platform/core', '2.7', 'The "access_control" option is deprecated and will be renamed to "security".');
  45.         } elseif ('access_control_message' === $key) {
  46.             $key = 'security_message';
  47.             trigger_deprecation('api-platform/core', '2.7', 'The "access_control_message" option is deprecated and will be renamed to "security_message".');
  48.         } elseif ('path' === $key) {
  49.             $key = 'uri_template';
  50.             trigger_deprecation('api-platform/core', '2.7', 'The "path" option is deprecated and will be renamed to "uri_template".');
  51.         // Transform default value to an empty array if null
  52.         } elseif (\in_array($key, ['denormalization_context', 'normalization_context', 'hydra_context', 'openapi_context', 'order', 'pagination_via_cursor', 'exception_to_status'], true)) {
  53.             if (null === $value) {
  54.                 $value = [];
  55.             } elseif (!\is_array($value)) {
  56.                 $value = [$value];
  57.             }
  58.         } elseif ('route_prefix' === $key) {
  59.             $value = \is_string($value) ? $value : '';
  60.         } elseif ('swagger_context' === $key) {
  61.             trigger_deprecation('api-platform/core', '2.7', 'The "swagger_context" option is deprecated and will be removed, use "openapi_context".');
  62.             $key = 'openapi_context';
  63.             $value = $value ?? [];
  64.         } elseif ('query_parameter_validation_enabled' === $key) {
  65.             $value = !$value ? false : $value;
  66.         // GraphQl related keys
  67.         } elseif (\in_array($key, ['collection_query', 'item_query', 'mutation'], true)) {
  68.             trigger_deprecation('api-platform/core', '2.7', 'To specify a GraphQl resolver use "resolver" instead of "mutation", "item_query" or "collection_query".');
  69.             $key = 'resolver';
  70.         } elseif ('filters' === $key) {
  71.             $value = null === $value ? [] : $value;
  72.         } elseif ('graphql' === $key) {
  73.             trigger_deprecation('api-platform/core', '2.7', 'The "graphql" option is deprecated and will be renamed to "graphQlOperations".');
  74.             $key = 'graphQlOperations';
  75.         } elseif ('identifiers' === $key) {
  76.             $key = 'uriVariables';
  77.         } elseif ('doctrine_mongodb' === $key) {
  78.             $key = 'extra_properties';
  79.             $value = ['doctrine_mongodb' => $value];
  80.         }
  82.         return [$this->camelCaseToSnakeCaseNameConverter->denormalize($key), $value];
  83.     }
  84. }