*/ private $phpDocInfosByObjectHash = []; public function __construct( PhpDocNodeMapper $phpDocNodeMapper, CurrentNodeProvider $currentNodeProvider, Lexer $lexer, BetterPhpDocParser $betterPhpDocParser, StaticTypeMapper $staticTypeMapper, AnnotationNaming $annotationNaming, RectorChangeCollector $rectorChangeCollector ) { $this->betterPhpDocParser = $betterPhpDocParser; $this->lexer = $lexer; $this->currentNodeProvider = $currentNodeProvider; $this->staticTypeMapper = $staticTypeMapper; $this->phpDocNodeMapper = $phpDocNodeMapper; $this->annotationNaming = $annotationNaming; $this->rectorChangeCollector = $rectorChangeCollector; } public function createFromNodeOrEmpty(Node $node): PhpDocInfo { // already added $phpDocInfo = $node->getAttribute(AttributeKey::PHP_DOC_INFO); if ($phpDocInfo instanceof PhpDocInfo) { return $phpDocInfo; } $phpDocInfo = $this->createFromNode($node); if ($phpDocInfo instanceof PhpDocInfo) { return $phpDocInfo; } return $this->createEmpty($node); } public function createFromNode(Node $node): ?PhpDocInfo { $objectHash = spl_object_hash($node); if (isset($this->phpDocInfosByObjectHash[$objectHash])) { return $this->phpDocInfosByObjectHash[$objectHash]; } /** needed for @see PhpDocNodeFactoryInterface */ $this->currentNodeProvider->setNode($node); $docComment = $node->getDocComment(); if (! $docComment instanceof Doc) { if ($node->getComments() !== []) { return null; } // create empty node $content = ''; $tokens = []; $phpDocNode = new PhpDocNode([]); } else { $content = $docComment->getText(); $tokens = $this->lexer->tokenize($content); $phpDocNode = $this->parseTokensToPhpDocNode($tokens); $this->setPositionOfLastToken($phpDocNode); } $phpDocInfo = $this->createFromPhpDocNode($phpDocNode, $content, $tokens, $node); $this->phpDocInfosByObjectHash[$objectHash] = $phpDocInfo; return $phpDocInfo; } public function createEmpty(Node $node): PhpDocInfo { /** needed for @see PhpDocNodeFactoryInterface */ $this->currentNodeProvider->setNode($node); $phpDocNode = new PhpDocNode([]); $phpDocInfo = $this->createFromPhpDocNode($phpDocNode, '', [], $node); // multiline by default $phpDocInfo->makeMultiLined(); return $phpDocInfo; } /** * @param mixed[][] $tokens */ private function parseTokensToPhpDocNode(array $tokens): PhpDocNode { $tokenIterator = new BetterTokenIterator($tokens); return $this->betterPhpDocParser->parse($tokenIterator); } /** * Needed for printing */ private function setPositionOfLastToken(PhpDocNode $phpDocNode): void { if ($phpDocNode->children === []) { return; } $phpDocChildNodes = $phpDocNode->children; $lastChildNode = array_pop($phpDocChildNodes); /** @var StartAndEnd $startAndEnd */ $startAndEnd = $lastChildNode->getAttribute(PhpDocAttributeKey::START_AND_END); if ($startAndEnd !== null) { $phpDocNode->setAttribute(PhpDocAttributeKey::LAST_TOKEN_POSITION, $startAndEnd->getEnd()); } } /** * @param mixed[] $tokens */ private function createFromPhpDocNode( PhpDocNode $phpDocNode, string $content, array $tokens, Node $node ): PhpDocInfo { $this->phpDocNodeMapper->transform($phpDocNode, new BetterTokenIterator($tokens)); $phpDocInfo = new PhpDocInfo( $phpDocNode, $tokens, $content, $this->staticTypeMapper, $node, $this->annotationNaming, $this->currentNodeProvider, $this->rectorChangeCollector ); $node->setAttribute(AttributeKey::PHP_DOC_INFO, $phpDocInfo); return $phpDocInfo; } }