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

Breadcrumb

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

class ArbitraryParenthesesSpacingSniff

Hierarchy

  • class \PHP_CodeSniffer\Standards\Generic\Sniffs\WhiteSpace\ArbitraryParenthesesSpacingSniff implements \PHP_CodeSniffer\Sniffs\Sniff

Expanded class hierarchy of ArbitraryParenthesesSpacingSniff

File

vendor/squizlabs/php_codesniffer/src/Standards/Generic/Sniffs/WhiteSpace/ArbitraryParenthesesSpacingSniff.php, line 19

Namespace

PHP_CodeSniffer\Standards\Generic\Sniffs\WhiteSpace
View source
class ArbitraryParenthesesSpacingSniff implements Sniff {
    
    /**
     * The number of spaces desired on the inside of the parentheses.
     *
     * @var integer
     */
    public $spacing = 0;
    
    /**
     * Allow newlines instead of spaces.
     *
     * @var boolean
     */
    public $ignoreNewlines = false;
    
    /**
     * Tokens which when they precede an open parenthesis indicate
     * that this is a type of structure this sniff should ignore.
     *
     * @var array
     */
    private $ignoreTokens = [];
    
    /**
     * Returns an array of tokens this test wants to listen for.
     *
     * @return array<int|string>
     */
    public function register() {
        $this->ignoreTokens = Tokens::$functionNameTokens;
        $this->ignoreTokens[T_VARIABLE] = T_VARIABLE;
        $this->ignoreTokens[T_CLOSE_PARENTHESIS] = T_CLOSE_PARENTHESIS;
        $this->ignoreTokens[T_CLOSE_CURLY_BRACKET] = T_CLOSE_CURLY_BRACKET;
        $this->ignoreTokens[T_CLOSE_SQUARE_BRACKET] = T_CLOSE_SQUARE_BRACKET;
        $this->ignoreTokens[T_CLOSE_SHORT_ARRAY] = T_CLOSE_SHORT_ARRAY;
        $this->ignoreTokens[T_USE] = T_USE;
        $this->ignoreTokens[T_THROW] = T_THROW;
        $this->ignoreTokens[T_YIELD] = T_YIELD;
        $this->ignoreTokens[T_YIELD_FROM] = T_YIELD_FROM;
        $this->ignoreTokens[T_CLONE] = T_CLONE;
        return [
            T_OPEN_PARENTHESIS,
            T_CLOSE_PARENTHESIS,
        ];
    }
    
    //end register()
    
    /**
     * Processes this test, when one of its tokens is encountered.
     *
     * @param \PHP_CodeSniffer\Files\File $phpcsFile All the tokens found in the document.
     * @param int                         $stackPtr  The position of the current token in
     *                                               the stack passed in $tokens.
     *
     * @return void|int
     */
    public function process(File $phpcsFile, $stackPtr) {
        $tokens = $phpcsFile->getTokens();
        if (isset($tokens[$stackPtr]['parenthesis_owner']) === true) {
            // This parenthesis is owned by a function/control structure etc.
            return;
        }
        // More checking for the type of parenthesis we *don't* want to handle.
        $opener = $stackPtr;
        if ($tokens[$stackPtr]['code'] === T_CLOSE_PARENTHESIS) {
            if (isset($tokens[$stackPtr]['parenthesis_opener']) === false) {
                // Parse error.
                return;
            }
            $opener = $tokens[$stackPtr]['parenthesis_opener'];
        }
        $preOpener = $phpcsFile->findPrevious(Tokens::$emptyTokens, $opener - 1, null, true);
        if ($preOpener !== false && isset($this->ignoreTokens[$tokens[$preOpener]['code']]) === true && ($tokens[$preOpener]['code'] !== T_CLOSE_CURLY_BRACKET || isset($tokens[$preOpener]['scope_condition']) === false)) {
            // Function or language construct call.
            return;
        }
        // Check for empty parentheses.
        if ($tokens[$stackPtr]['code'] === T_OPEN_PARENTHESIS && isset($tokens[$stackPtr]['parenthesis_closer']) === true) {
            $nextNonEmpty = $phpcsFile->findNext(T_WHITESPACE, $stackPtr + 1, null, true);
            if ($nextNonEmpty === $tokens[$stackPtr]['parenthesis_closer']) {
                $phpcsFile->addWarning('Empty set of arbitrary parentheses found.', $stackPtr, 'FoundEmpty');
                return $tokens[$stackPtr]['parenthesis_closer'] + 1;
            }
        }
        // Check the spacing on the inside of the parentheses.
        $this->spacing = (int) $this->spacing;
        if ($tokens[$stackPtr]['code'] === T_OPEN_PARENTHESIS && isset($tokens[$stackPtr + 1], $tokens[$stackPtr + 2]) === true) {
            $nextToken = $tokens[$stackPtr + 1];
            if ($nextToken['code'] !== T_WHITESPACE) {
                $inside = 0;
            }
            else {
                if ($tokens[$stackPtr + 2]['line'] !== $tokens[$stackPtr]['line']) {
                    $inside = 'newline';
                }
                else {
                    $inside = $nextToken['length'];
                }
            }
            if ($this->spacing !== $inside && ($inside !== 'newline' || $this->ignoreNewlines === false)) {
                $error = 'Expected %s space after open parenthesis; %s found';
                $data = [
                    $this->spacing,
                    $inside,
                ];
                $fix = $phpcsFile->addFixableError($error, $stackPtr, 'SpaceAfterOpen', $data);
                if ($fix === true) {
                    $expected = '';
                    if ($this->spacing > 0) {
                        $expected = str_repeat(' ', $this->spacing);
                    }
                    if ($inside === 0) {
                        if ($expected !== '') {
                            $phpcsFile->fixer
                                ->addContent($stackPtr, $expected);
                        }
                    }
                    else {
                        if ($inside === 'newline') {
                            $phpcsFile->fixer
                                ->beginChangeset();
                            for ($i = $stackPtr + 2; $i < $phpcsFile->numTokens; $i++) {
                                if ($tokens[$i]['code'] !== T_WHITESPACE) {
                                    break;
                                }
                                $phpcsFile->fixer
                                    ->replaceToken($i, '');
                            }
                            $phpcsFile->fixer
                                ->replaceToken($stackPtr + 1, $expected);
                            $phpcsFile->fixer
                                ->endChangeset();
                        }
                        else {
                            $phpcsFile->fixer
                                ->replaceToken($stackPtr + 1, $expected);
                        }
                    }
                }
                
                //end if
            }
            
            //end if
        }
        
        //end if
        if ($tokens[$stackPtr]['code'] === T_CLOSE_PARENTHESIS && isset($tokens[$stackPtr - 1], $tokens[$stackPtr - 2]) === true) {
            $prevToken = $tokens[$stackPtr - 1];
            if ($prevToken['code'] !== T_WHITESPACE) {
                $inside = 0;
            }
            else {
                if ($tokens[$stackPtr - 2]['line'] !== $tokens[$stackPtr]['line']) {
                    $inside = 'newline';
                }
                else {
                    $inside = $prevToken['length'];
                }
            }
            if ($this->spacing !== $inside && ($inside !== 'newline' || $this->ignoreNewlines === false)) {
                $error = 'Expected %s space before close parenthesis; %s found';
                $data = [
                    $this->spacing,
                    $inside,
                ];
                $fix = $phpcsFile->addFixableError($error, $stackPtr, 'SpaceBeforeClose', $data);
                if ($fix === true) {
                    $expected = '';
                    if ($this->spacing > 0) {
                        $expected = str_repeat(' ', $this->spacing);
                    }
                    if ($inside === 0) {
                        if ($expected !== '') {
                            $phpcsFile->fixer
                                ->addContentBefore($stackPtr, $expected);
                        }
                    }
                    else {
                        if ($inside === 'newline') {
                            $phpcsFile->fixer
                                ->beginChangeset();
                            for ($i = $stackPtr - 2; $i > 0; $i--) {
                                if ($tokens[$i]['code'] !== T_WHITESPACE) {
                                    break;
                                }
                                $phpcsFile->fixer
                                    ->replaceToken($i, '');
                            }
                            $phpcsFile->fixer
                                ->replaceToken($stackPtr - 1, $expected);
                            $phpcsFile->fixer
                                ->endChangeset();
                        }
                        else {
                            $phpcsFile->fixer
                                ->replaceToken($stackPtr - 1, $expected);
                        }
                    }
                }
                
                //end if
            }
            
            //end if
        }
        
        //end if
    }
    
    //end process()

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
ArbitraryParenthesesSpacingSniff::$ignoreNewlines public property Allow newlines instead of spaces.
ArbitraryParenthesesSpacingSniff::$ignoreTokens private property Tokens which when they precede an open parenthesis indicate
that this is a type of structure this sniff should ignore.
ArbitraryParenthesesSpacingSniff::$spacing public property The number of spaces desired on the inside of the parentheses.
ArbitraryParenthesesSpacingSniff::process public function Processes this test, when one of its tokens is encountered. Overrides Sniff::process
ArbitraryParenthesesSpacingSniff::register public function Returns an array of tokens this test wants to listen for. Overrides Sniff::register

API Navigation

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