MO4\Sniffs\Commenting\PropertyCommentSniff::processTokenWithinScope()

Complexity

Conditions	20
Paths	68

Size

Total Lines	157
Code Lines	97

Duplication

Lines	0
Ratio	0 %

Importance

Changes

0

<?php
    protected function processTokenWithinScope(
        File $phpcsFile,
        $stackPtr,
        $currScope
    ) {
        $find   = array(
                   T_COMMENT,
                   T_DOC_COMMENT_CLOSE_TAG,
                   T_CLASS,
                   T_CONST,
                   T_FUNCTION,
                   T_VARIABLE,
                   T_OPEN_TAG,
                  );
        $tokens = $phpcsFile->getTokens();

        // Before even checking the docblocks above the current var/const,
        // check if we have a single line comment after it on the same line,
        // and if that one is OK.
        $postComment = $phpcsFile->findNext(
            array(T_DOC_COMMENT_OPEN_TAG),
            $stackPtr
        );
        if ($postComment !== false
            && $tokens[$postComment]['line'] === $tokens[$stackPtr]['line']
        ) {
            if ($tokens[$postComment]['content'] === '/**') {
                // That's an error already.
                $phpcsFile->addError(
                    'no doc blocks are allowed after declaration',
                    $stackPtr,
                    'NoDocBlockAllowed'
                );
            } else {
                $postCommentEnd  = $tokens[$postComment]['comment_closer'];
                $postCommentLine = $tokens[$postCommentEnd]['line'];
                if ($tokens[$postComment]['line'] !== $postCommentLine) {
                    $phpcsFile->addError(
                        'no multiline comments after declarations allowed',
                        $stackPtr,
                        'MustBeOneLine'
                    );
                }
            }
        }

        // Don't do constants for now.
        if ($tokens[$stackPtr]['code'] === T_CONST) {
            return;
        }

        $commentEnd = $phpcsFile->findPrevious($find, ($stackPtr - 1));
        if ($commentEnd === false) {
            return;
        }

        $commentEnd = (int) $commentEnd;

        $conditions    = $tokens[$commentEnd]['conditions'];
        $lastCondition = array_pop($conditions);
        if ($lastCondition !== T_CLASS) {
            return;
        }

        $code = $tokens[$commentEnd]['code'];

        if ($code === T_DOC_COMMENT_CLOSE_TAG) {
            $commentStart = $tokens[$commentEnd]['comment_opener'];

            // Check if this comment is completely in one line,
            // above the current line,
            // and has a variable preceding it in the same line.
            // If yes, it doesn't count.
            $firstTokenOnLine = $phpcsFile->findFirstOnLine(
                $this->myTokenTypes,
                $commentEnd
            );
            if ($firstTokenOnLine !== false
                && $tokens[$commentStart]['line'] === $tokens[$commentEnd]['line']
                && $tokens[$stackPtr]['line'] > $tokens[$commentEnd]['line']
            ) {
                return;
            }

            $isCommentOneLiner
                = $tokens[$commentStart]['line'] === $tokens[$commentEnd]['line'];

            $length         = ($commentEnd - $commentStart + 1);
            $tokensAsString = $phpcsFile->getTokensAsString(
                $commentStart,
                $length
            );

            $varCount = (count(preg_split('/\s+@var\s+/', $tokensAsString)) - 1);
            if (($varCount === 0) || ($varCount > 1)) {
                $phpcsFile->addError(
                    'property doc comment must have exactly one @var annotation',
                    $commentStart,
                    'MustHaveOneVarAnnotationDefined'
                );
            }

            if ($varCount === 1) {
                if ($isCommentOneLiner === true) {
                    $fix = $phpcsFile->addFixableError(
                        'property doc comment must be multi line',
                        $commentEnd,
                        'NotMultiLineDocBlock'
                    );

                    if ($fix === true) {
                        $phpcsFile->fixer->beginChangeset();
                        $phpcsFile->fixer->addContent($commentStart, "\n     *");
                        $phpcsFile->fixer->replaceToken(
                            ($commentEnd - 1),
                            rtrim($tokens[($commentEnd - 1)]['content'])
                        );
                        $phpcsFile->fixer->addContentBefore($commentEnd, "\n     ");
                        $phpcsFile->fixer->endChangeset();
                    }
                }
            } else {
                if ($isCommentOneLiner === true) {
                    $phpcsFile->addError(
                        'property doc comment must be multi line',
                        $commentEnd,
                        'NotMultiLineDocBlock'
                    );
                }
            }//end if
        } else if ($code === T_COMMENT) {
            // It seems that when we are in here,
            // then we have a line comment at $commentEnd.
            // Now, check if the same comment has
            // a variable definition on the same line.
            // If yes, it doesn't count.
            $firstOnLine = $phpcsFile->findFirstOnLine(
                $this->myTokenTypes,
                $commentEnd
            );

            if ($firstOnLine === false) {
                $commentStart = $phpcsFile->findPrevious(
                    T_COMMENT,
                    $commentEnd,
                    null,
                    true
                );
                $phpcsFile->addError(
                    'property doc comment must begin with /**',
                    ($commentStart + 1),
                    'NotADocBlock'
                );
            }
        }//end if

    }//end processTokenWithinScope()