function LineLengthSniff::checkLineLength

Same name in this branch

1. 11.1.x vendor/slevomat/coding-standard/SlevomatCodingStandard/Sniffs/Files/LineLengthSniff.php \SlevomatCodingStandard\Sniffs\Files\LineLengthSniff::checkLineLength()
2. 11.1.x vendor/squizlabs/php_codesniffer/src/Standards/Generic/Sniffs/Files/LineLengthSniff.php \PHP_CodeSniffer\Standards\Generic\Sniffs\Files\LineLengthSniff::checkLineLength()

Checks if a line is too long.

Parameters

\PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.:

array<int, mixed> $tokens The token stack.:

int $stackPtr The first token on the next line.:

Return value

void

Overrides LineLengthSniff::checkLineLength

File

vendor/drupal/coder/coder_sniffer/Drupal/Sniffs/Files/LineLengthSniff.php, line 54

Class

LineLengthSniff

Checks comment lines in the file, and throws warnings if they are over 80 characters in length.

Namespace

Drupal\Sniffs\Files

Code

protected function checkLineLength($phpcsFile, $tokens, $stackPtr) {
    if (isset(Tokens::$commentTokens[$tokens[$stackPtr - 1]['code']]) === true) {
        $docCommentTag = $phpcsFile->findFirstOnLine(T_DOC_COMMENT_TAG, $stackPtr - 1);
        if ($docCommentTag !== false) {
            // Allow doc comment tags such as long @param tags to exceed the 80
            // character limit.
            return;
        }
        if ($tokens[$stackPtr - 1]['code'] === T_COMMENT && (preg_match('/^[[:space:]]*\\/\\/ @.+/', $tokens[$stackPtr - 1]['content']) === 1 || strpos(trim($tokens[$stackPtr - 1]['content'], "/ \n"), ' ') === false)) {
            return;
        }
        // Code examples between @code and @endcode are allowed to exceed 80
        // characters.
        if (isset($tokens[$stackPtr]) === true && $tokens[$stackPtr]['code'] === T_DOC_COMMENT_WHITESPACE) {
            $tag = $phpcsFile->findPrevious([
                T_DOC_COMMENT_TAG,
                T_DOC_COMMENT_OPEN_TAG,
            ], $stackPtr - 1);
            if ($tokens[$tag]['content'] === '@code') {
                return;
            }
        }
        // Drupal 8 annotations can have long translatable descriptions and we
        // allow them to exceed 80 characters.
        if ($tokens[$stackPtr - 2]['code'] === T_DOC_COMMENT_STRING && (strpos($tokens[$stackPtr - 2]['content'], '@Translation(') !== false || strpos($tokens[$stackPtr - 2]['content'], ' ') === false || preg_match('/^Contains [a-zA-Z_\\\\.]+$/', $tokens[$stackPtr - 2]['content']) === 1 || preg_match('#= ("|\')?\\S+[\\\\/]\\S+("|\')?,*$#', $tokens[$stackPtr - 2]['content']) === 1) || strpos($tokens[$stackPtr - 2]['content'], '- @link') !== false || preg_match('/^Implements hook_[a-zA-Z0-9_]+\\(\\)/', $tokens[$stackPtr - 2]['content']) === 1) {
            return;
        }
        parent::checkLineLength($phpcsFile, $tokens, $stackPtr);
    }
    
    //end if
}