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

Breadcrumb

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

class NamespaceSpacingSniff

Hierarchy

  • class \SlevomatCodingStandard\Sniffs\Namespaces\NamespaceSpacingSniff implements \PHP_CodeSniffer\Sniffs\Sniff

Expanded class hierarchy of NamespaceSpacingSniff

File

vendor/slevomat/coding-standard/SlevomatCodingStandard/Sniffs/Namespaces/NamespaceSpacingSniff.php, line 21

Namespace

SlevomatCodingStandard\Sniffs\Namespaces
View source
class NamespaceSpacingSniff implements Sniff {
    public const CODE_INCORRECT_LINES_COUNT_BEFORE_NAMESPACE = 'IncorrectLinesCountBeforeNamespace';
    public const CODE_INCORRECT_LINES_COUNT_AFTER_NAMESPACE = 'IncorrectLinesCountAfterNamespace';
    
    /** @var int */
    public $linesCountBeforeNamespace = 1;
    
    /** @var int */
    public $linesCountAfterNamespace = 1;
    
    /**
     * @return array<int, (int|string)>
     */
    public function register() : array {
        return [
            T_NAMESPACE,
        ];
    }
    
    /**
     * @phpcsSuppress SlevomatCodingStandard.TypeHints.ParameterTypeHint.MissingNativeTypeHint
     * @param int $namespacePointer
     */
    public function process(File $phpcsFile, $namespacePointer) : void {
        $this->linesCountBeforeNamespace = SniffSettingsHelper::normalizeInteger($this->linesCountBeforeNamespace);
        $this->linesCountAfterNamespace = SniffSettingsHelper::normalizeInteger($this->linesCountAfterNamespace);
        $this->checkLinesBeforeNamespace($phpcsFile, $namespacePointer);
        $this->checkLinesAfterNamespace($phpcsFile, $namespacePointer);
    }
    private function checkLinesBeforeNamespace(File $phpcsFile, int $namespacePointer) : void {
        $tokens = $phpcsFile->getTokens();
        
        /** @var int $pointerBeforeNamespace */
        $pointerBeforeNamespace = TokenHelper::findPreviousNonWhitespace($phpcsFile, $namespacePointer - 1);
        $whitespaceBeforeNamespace = '';
        $isInlineCommentBefore = (bool) preg_match('~^(?://|#)(.*)~', $tokens[$pointerBeforeNamespace]['content']);
        if ($tokens[$pointerBeforeNamespace]['code'] === T_OPEN_TAG) {
            $whitespaceBeforeNamespace .= substr($tokens[$pointerBeforeNamespace]['content'], strlen('<?php'));
        }
        elseif ($isInlineCommentBefore) {
            $whitespaceBeforeNamespace .= $phpcsFile->eolChar;
        }
        if ($pointerBeforeNamespace + 1 !== $namespacePointer) {
            $whitespaceBeforeNamespace .= TokenHelper::getContent($phpcsFile, $pointerBeforeNamespace + 1, $namespacePointer - 1);
        }
        $actualLinesCountBeforeNamespace = substr_count($whitespaceBeforeNamespace, $phpcsFile->eolChar) - 1;
        if ($actualLinesCountBeforeNamespace === $this->linesCountBeforeNamespace) {
            return;
        }
        $fix = $phpcsFile->addFixableError(sprintf('Expected %d line%s before namespace statement, found %d.', $this->linesCountBeforeNamespace, $this->linesCountBeforeNamespace === 1 ? '' : 's', $actualLinesCountBeforeNamespace), $namespacePointer, self::CODE_INCORRECT_LINES_COUNT_BEFORE_NAMESPACE);
        if (!$fix) {
            return;
        }
        $phpcsFile->fixer
            ->beginChangeset();
        if ($tokens[$pointerBeforeNamespace]['code'] === T_OPEN_TAG) {
            $phpcsFile->fixer
                ->replaceToken($pointerBeforeNamespace, '<?php');
        }
        elseif ($isInlineCommentBefore) {
            $phpcsFile->fixer
                ->replaceToken($pointerBeforeNamespace, rtrim($tokens[$pointerBeforeNamespace]['content'], $phpcsFile->eolChar));
        }
        FixerHelper::removeBetween($phpcsFile, $pointerBeforeNamespace, $namespacePointer);
        for ($i = 0; $i <= $this->linesCountBeforeNamespace; $i++) {
            $phpcsFile->fixer
                ->addNewline($pointerBeforeNamespace);
        }
        $phpcsFile->fixer
            ->endChangeset();
    }
    private function checkLinesAfterNamespace(File $phpcsFile, int $namespacePointer) : void {
        if (array_key_exists('scope_opener', $phpcsFile->getTokens()[$namespacePointer])) {
            return;
        }
        
        /** @var int $namespaceSemicolonPointer */
        $namespaceSemicolonPointer = TokenHelper::findNextLocal($phpcsFile, T_SEMICOLON, $namespacePointer + 1);
        $pointerAfterWhitespaceEnd = TokenHelper::findNextNonWhitespace($phpcsFile, $namespaceSemicolonPointer + 1);
        if ($pointerAfterWhitespaceEnd === null) {
            return;
        }
        $whitespaceAfterNamespace = TokenHelper::getContent($phpcsFile, $namespaceSemicolonPointer + 1, $pointerAfterWhitespaceEnd - 1);
        $actualLinesCountAfterNamespace = substr_count($whitespaceAfterNamespace, $phpcsFile->eolChar) - 1;
        if ($actualLinesCountAfterNamespace === $this->linesCountAfterNamespace) {
            return;
        }
        $fix = $phpcsFile->addFixableError(sprintf('Expected %d line%s after namespace statement, found %d.', $this->linesCountAfterNamespace, $this->linesCountAfterNamespace === 1 ? '' : 's', $actualLinesCountAfterNamespace), $namespacePointer, self::CODE_INCORRECT_LINES_COUNT_AFTER_NAMESPACE);
        if (!$fix) {
            return;
        }
        $phpcsFile->fixer
            ->beginChangeset();
        FixerHelper::removeBetween($phpcsFile, $namespaceSemicolonPointer, $pointerAfterWhitespaceEnd);
        for ($i = 0; $i <= $this->linesCountAfterNamespace; $i++) {
            $phpcsFile->fixer
                ->addNewline($namespaceSemicolonPointer);
        }
        $phpcsFile->fixer
            ->endChangeset();
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
NamespaceSpacingSniff::$linesCountAfterNamespace public property @var int
NamespaceSpacingSniff::$linesCountBeforeNamespace public property @var int
NamespaceSpacingSniff::checkLinesAfterNamespace private function
NamespaceSpacingSniff::checkLinesBeforeNamespace private function
NamespaceSpacingSniff::CODE_INCORRECT_LINES_COUNT_AFTER_NAMESPACE public constant
NamespaceSpacingSniff::CODE_INCORRECT_LINES_COUNT_BEFORE_NAMESPACE public constant
NamespaceSpacingSniff::process public function * @phpcsSuppress SlevomatCodingStandard.TypeHints.ParameterTypeHint.MissingNativeTypeHint
*
Overrides Sniff::process
NamespaceSpacingSniff::register public function * Overrides Sniff::register

API Navigation

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