vendor/symfony/dependency-injection/Attribute/Autowire.php line 35

  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.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. namespace Symfony\Component\DependencyInjection\Attribute;
  14. use Symfony\Component\DependencyInjection\Exception\LogicException;
  15. use Symfony\Component\DependencyInjection\Reference;
  16. use Symfony\Component\ExpressionLanguage\Expression;
  18. /**
  19.  * Attribute to tell a parameter how to be autowired.
  20.  *
  21.  * @author Kevin Bond <kevinbond@gmail.com>
  22.  */
  23. #[\Attribute(\Attribute::TARGET_PARAMETER)]
  24. class Autowire
  25. {
  26.     public readonly string|array|Expression|Reference $value;
  28.     /**
  29.      * Use only ONE of the following.
  30.      *
  31.      * @param string|null $value      Parameter value (ie "%kernel.project_dir%/some/path")
  32.      * @param string|null $service    Service ID (ie "some.service")
  33.      * @param string|null $expression Expression (ie 'service("some.service").someMethod()')
  34.      */
  35.     public function __construct(
  36.         string|array $value = null,
  37.         string $service = null,
  38.         string $expression = null,
  39.     ) {
  40.         if (!($service xor $expression xor null !== $value)) {
  41.             throw new LogicException('#[Autowire] attribute must declare exactly one of $service, $expression, or $value.');
  42.         }
  44.         if (\is_string($value) && str_starts_with($value, '@')) {
  45.             match (true) {
  46.                 str_starts_with($value, '@@') => $value = substr($value, 1),
  47.                 str_starts_with($value, '@=') => $expression = substr($value, 2),
  48.                 default => $service = substr($value, 1),
  49.             };
  50.         }
  52.         $this->value = match (true) {
  53.             null !== $service => new Reference($service),
  54.             null !== $expression => class_exists(Expression::class) ? new Expression($expression) : throw new LogicException('Unable to use expressions as the Symfony ExpressionLanguage component is not installed. Try running "composer require symfony/expression-language".'),
  55.             null !== $value => $value,
  56.         };
  57.     }
  58. }