Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. AutowireRequiredMethodsPass.php

class AutowireRequiredMethodsPass

Looks for definitions with autowiring enabled and registers their corresponding "#[Required]" methods as setters.

@author Nicolas Grekas <p@tchwork.com>

Hierarchy

  • class \Symfony\Component\DependencyInjection\Compiler\AbstractRecursivePass implements \Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface
    • class \Symfony\Component\DependencyInjection\Compiler\AutowireRequiredMethodsPass extends \Symfony\Component\DependencyInjection\Compiler\AbstractRecursivePass

Expanded class hierarchy of AutowireRequiredMethodsPass

File

vendor/symfony/dependency-injection/Compiler/AutowireRequiredMethodsPass.php, line 22

Namespace

Symfony\Component\DependencyInjection\Compiler
View source
class AutowireRequiredMethodsPass extends AbstractRecursivePass {
    protected bool $skipScalars = true;
    protected function processValue(mixed $value, bool $isRoot = false) : mixed {
        $value = parent::processValue($value, $isRoot);
        if (!$value instanceof Definition || !$value->isAutowired() || $value->isAbstract() || !$value->getClass()) {
            return $value;
        }
        if (!($reflectionClass = $this->container
            ->getReflectionClass($value->getClass(), false))) {
            return $value;
        }
        $alreadyCalledMethods = [];
        $withers = [];
        foreach ($value->getMethodCalls() as [
            $method,
        ]) {
            $alreadyCalledMethods[strtolower($method)] = true;
        }
        foreach ($reflectionClass->getMethods() as $reflectionMethod) {
            $r = $reflectionMethod;
            if ($r->isConstructor() || isset($alreadyCalledMethods[strtolower($r->name)])) {
                continue;
            }
            while (true) {
                if ($r->getAttributes(Required::class)) {
                    if ($this->isWither($r, $r->getDocComment() ?: '')) {
                        $withers[] = [
                            $r->name,
                            [],
                            true,
                        ];
                    }
                    else {
                        $value->addMethodCall($r->name, []);
                    }
                    break;
                }
                try {
                    $r = $r->getPrototype();
                } catch (\ReflectionException) {
                    break;
                    // method has no prototype
                }
            }
        }
        if ($withers) {
            // Prepend withers to prevent creating circular loops
            $setters = $value->getMethodCalls();
            $value->setMethodCalls($withers);
            foreach ($setters as $call) {
                $value->addMethodCall($call[0], $call[1], $call[2] ?? false);
            }
        }
        return $value;
    }
    private function isWither(\ReflectionMethod $reflectionMethod, string $doc) : bool {
        $match = preg_match('#(?:^/\\*\\*|\\n\\s*+\\*)\\s*+@return\\s++(static|\\$this)[\\s\\*]#i', $doc, $matches);
        if ($match && 'static' === $matches[1]) {
            return true;
        }
        if ($match && '$this' === $matches[1]) {
            return false;
        }
        $reflectionType = $reflectionMethod->hasReturnType() ? $reflectionMethod->getReturnType() : null;
        return $reflectionType instanceof \ReflectionNamedType && 'static' === $reflectionType->getName();
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
AbstractRecursivePass::$container protected property
AbstractRecursivePass::$currentId protected property
AbstractRecursivePass::$expressionLanguage private property 1
AbstractRecursivePass::$inExpression private property
AbstractRecursivePass::$processExpressions private property
AbstractRecursivePass::enableExpressionProcessing protected function
AbstractRecursivePass::getConstructor protected function
AbstractRecursivePass::getExpressionLanguage private function 1
AbstractRecursivePass::getReflectionMethod protected function
AbstractRecursivePass::inExpression protected function
AbstractRecursivePass::process public function Overrides CompilerPassInterface::process 15
AutowireRequiredMethodsPass::$skipScalars protected property Overrides AbstractRecursivePass::$skipScalars
AutowireRequiredMethodsPass::isWither private function
AutowireRequiredMethodsPass::processValue protected function Processes a value found in a definition tree. Overrides AbstractRecursivePass::processValue

API Navigation

  • Drupal Core 11.1.x
  • Topics
  • Classes
  • Functions
  • Constants
  • Globals
  • Files
  • Namespaces
  • Deprecated
  • Services
RSS feed
Powered by Drupal