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

Breadcrumb

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

function FullyQualifiedClassNameInAnnotationSniff::process

* @phpcsSuppress SlevomatCodingStandard.TypeHints.ParameterTypeHint.MissingNativeTypeHint *

Parameters

int $docCommentOpenPointer:

Overrides Sniff::process

File

vendor/slevomat/coding-standard/SlevomatCodingStandard/Sniffs/Namespaces/FullyQualifiedClassNameInAnnotationSniff.php, line 45

Class

FullyQualifiedClassNameInAnnotationSniff

Namespace

SlevomatCodingStandard\Sniffs\Namespaces

Code

public function process(File $phpcsFile, $docCommentOpenPointer) : void {
    $annotations = AnnotationHelper::getAnnotations($phpcsFile, $docCommentOpenPointer);
    $this->ignoredAnnotationNames = SniffSettingsHelper::normalizeArray($this->ignoredAnnotationNames);
    foreach ($annotations as $annotation) {
        
        /** @var list<IdentifierTypeNode> $identifierTypeNodes */
        $identifierTypeNodes = AnnotationHelper::getAnnotationNodesByType($annotation->getNode(), IdentifierTypeNode::class);
        $annotationName = $annotation->getName();
        foreach ($identifierTypeNodes as $typeHintNode) {
            $typeHint = $typeHintNode->name;
            $lowercasedTypeHint = strtolower($typeHint);
            if (TypeHintHelper::isSimpleTypeHint($lowercasedTypeHint) || TypeHintHelper::isSimpleUnofficialTypeHints($lowercasedTypeHint) || !TypeHelper::isTypeName($typeHint) || TypeHintHelper::isTypeDefinedInAnnotation($phpcsFile, $docCommentOpenPointer, $typeHint)) {
                continue;
            }
            if (in_array($annotationName, $this->ignoredAnnotationNames, true)) {
                continue;
            }
            $fullyQualifiedTypeHint = TypeHintHelper::getFullyQualifiedTypeHint($phpcsFile, $docCommentOpenPointer, $typeHint);
            if ($fullyQualifiedTypeHint === $typeHint) {
                continue;
            }
            $fix = $phpcsFile->addFixableError(sprintf('Class name %s in %s should be referenced via a fully qualified name.', $fullyQualifiedTypeHint, $annotationName), $annotation->getStartPointer(), self::CODE_NON_FULLY_QUALIFIED_CLASS_NAME);
            if (!$fix) {
                continue;
            }
            $parsedDocComment = DocCommentHelper::parseDocComment($phpcsFile, $docCommentOpenPointer);
            $fixedDocComment = AnnotationHelper::fixAnnotation($parsedDocComment, $annotation, $typeHintNode, new IdentifierTypeNode($fullyQualifiedTypeHint));
            $phpcsFile->fixer
                ->beginChangeset();
            FixerHelper::change($phpcsFile, $parsedDocComment->getOpenPointer(), $parsedDocComment->getClosePointer(), $fixedDocComment);
            $phpcsFile->fixer
                ->endChangeset();
        }
        
        /** @var list<ConstFetchNode> $constantFetchNodes */
        $constantFetchNodes = AnnotationHelper::getAnnotationNodesByType($annotation->getNode(), ConstFetchNode::class);
        foreach ($constantFetchNodes as $constantFetchNode) {
            $isClassConstant = $constantFetchNode->className !== '';
            $typeHint = $isClassConstant ? $constantFetchNode->className : $constantFetchNode->name;
            if ($typeHint === 'self') {
                continue;
            }
            $fullyQualifiedTypeHint = $isClassConstant ? NamespaceHelper::resolveClassName($phpcsFile, $typeHint, $docCommentOpenPointer) : NamespaceHelper::resolveName($phpcsFile, $typeHint, ReferencedName::TYPE_CONSTANT, $docCommentOpenPointer);
            if ($fullyQualifiedTypeHint === $typeHint) {
                continue;
            }
            $fix = $phpcsFile->addFixableError(sprintf('%s name %s in %s should be referenced via a fully qualified name.', $isClassConstant ? 'Class' : 'Constant', $fullyQualifiedTypeHint, $annotationName), $annotation->getStartPointer(), self::CODE_NON_FULLY_QUALIFIED_CLASS_NAME);
            if (!$fix) {
                continue;
            }
            $fixedConstantFetchNode = PhpDocParserHelper::cloneNode($constantFetchNode);
            if ($isClassConstant) {
                $fixedConstantFetchNode->className = $fullyQualifiedTypeHint;
            }
            else {
                $fixedConstantFetchNode->name = $fullyQualifiedTypeHint;
            }
            $parsedDocComment = DocCommentHelper::parseDocComment($phpcsFile, $docCommentOpenPointer);
            $fixedDocComment = AnnotationHelper::fixAnnotation($parsedDocComment, $annotation, $constantFetchNode, $fixedConstantFetchNode);
            $phpcsFile->fixer
                ->beginChangeset();
            FixerHelper::change($phpcsFile, $parsedDocComment->getOpenPointer(), $parsedDocComment->getClosePointer(), $fixedDocComment);
            $phpcsFile->fixer
                ->endChangeset();
        }
    }
}

API Navigation

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