Source for file ControlStructureSpacingSniff.php
Documentation is available at ControlStructureSpacingSniff.php
* Checks that control structures have the correct spacing around brackets.
* @author Greg Sherwood <gsherwood@squiz.net>
* @copyright 2006-2015 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
namespace PHP_CodeSniffer\Standards\PSR2\Sniffs\ControlStructures;
use PHP_CodeSniffer\Sniffs\Sniff;
use PHP_CodeSniffer\Files\File;
class ControlStructureSpacingSniff implements Sniff
* How many spaces should follow the opening bracket.
public $requiredSpacesAfterOpen = 0;
* How many spaces should precede the closing bracket.
public $requiredSpacesBeforeClose = 0;
* Returns an array of tokens this test wants to listen for.
public function register ()
* Processes this test, when one of its tokens is encountered.
* @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
* @param int $stackPtr The position of the current token
* in the stack passed in $tokens.
public function process (File $phpcsFile, $stackPtr)
$this->requiredSpacesAfterOpen = (int) $this->requiredSpacesAfterOpen;
$this->requiredSpacesBeforeClose = (int) $this->requiredSpacesBeforeClose;
$tokens = $phpcsFile->getTokens ();
if (isset ($tokens[$stackPtr]['parenthesis_opener']) === false
|| isset ($tokens[$stackPtr]['parenthesis_closer']) === false
$parenOpener = $tokens[$stackPtr]['parenthesis_opener'];
$parenCloser = $tokens[$stackPtr]['parenthesis_closer'];
if ($tokens[($parenOpener + 1 )]['code'] === T_WHITESPACE ) {
if (strpos($tokens[($parenOpener + 1 )]['content'], $phpcsFile->eolChar ) !== false ) {
$spaceAfterOpen = 'newline';
$spaceAfterOpen = strlen($tokens[($parenOpener + 1 )]['content']);
$phpcsFile->recordMetric ($stackPtr, 'Spaces after control structure open parenthesis', $spaceAfterOpen);
if ($spaceAfterOpen !== $this->requiredSpacesAfterOpen) {
$error = 'Expected %s spaces after opening bracket; %s found';
$this->requiredSpacesAfterOpen,
$fix = $phpcsFile->addFixableError ($error, ($parenOpener + 1 ), 'SpacingAfterOpenBrace', $data);
$padding = str_repeat(' ', $this->requiredSpacesAfterOpen);
if ($spaceAfterOpen === 0 ) {
$phpcsFile->fixer ->addContent ($parenOpener, $padding);
} else if ($spaceAfterOpen === 'newline') {
$phpcsFile->fixer ->replaceToken (($parenOpener + 1 ), '');
$phpcsFile->fixer ->replaceToken (($parenOpener + 1 ), $padding);
if ($tokens[$parenOpener]['line'] === $tokens[$parenCloser]['line']) {
if ($tokens[($parenCloser - 1 )]['code'] === T_WHITESPACE ) {
$spaceBeforeClose = strlen(ltrim($tokens[($parenCloser - 1 )]['content'], $phpcsFile->eolChar ));
$phpcsFile->recordMetric ($stackPtr, 'Spaces before control structure close parenthesis', $spaceBeforeClose);
if ($spaceBeforeClose !== $this->requiredSpacesBeforeClose) {
$error = 'Expected %s spaces before closing bracket; %s found';
$this->requiredSpacesBeforeClose,
$fix = $phpcsFile->addFixableError ($error, ($parenCloser - 1 ), 'SpaceBeforeCloseBrace', $data);
$padding = str_repeat(' ', $this->requiredSpacesBeforeClose);
if ($spaceBeforeClose === 0 ) {
$phpcsFile->fixer ->addContentBefore ($parenCloser, $padding);
$phpcsFile->fixer ->replaceToken (($parenCloser - 1 ), $padding);
Documentation generated on Mon, 11 Mar 2019 15:27:21 -0400 by phpDocumentor 1.4.4. PEAR Logo Copyright © PHP Group 2004.
|