vendor/nelmio/api-doc-bundle/src/Attribute/Areas.php line 29

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the NelmioApiDocBundle package.
  5.  *
  6.  * (c) Nelmio
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Nelmio\ApiDocBundle\Attribute;
  14. /**
  15.  * @final
  16.  */
  17. #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD)]
  18. class Areas
  19. {
  20.     /** @var string[] */
  21.     private array $areas;
  23.     /**
  24.      * @param string[]|array{value: string[]} $properties
  25.      */
  26.     public function __construct(array $properties)
  27.     {
  28.         if (array_key_exists('value', $properties) && is_array($properties['value'])) {
  29.             trigger_deprecation('nelmio/api-doc-bundle', '4.36.1', 'Passing an array with key "value" to "%s" is deprecated, pass the list of strings directly.', __METHOD__);
  31.             $this->areas = array_values($properties['value']);
  32.         } else {
  33.             $this->areas = [];
  34.             foreach ($properties as $area) {
  35.                 if (!is_string($area)) {
  36.                     throw new \InvalidArgumentException('An area must be given as a string');
  37.                 }
  39.                 if (!in_array($area, $this->areas, true)) {
  40.                     $this->areas[] = $area;
  41.                 }
  42.             }
  43.         }
  45.         if ([] === $this->areas) {
  46.             throw new \InvalidArgumentException('A list of areas was expected');
  47.         }
  48.     }
  50.     public function has(string $area): bool
  51.     {
  52.         return in_array($area, $this->areas, true);
  53.     }
  54. }