<?php
/**
* Squiz_Sniffs_ControlStructures_ForEachLoopDeclarationSniff.
*
* PHP version 5
*
* @category PHP
* @package PHP_CodeSniffer
* @author Greg Sherwood <gsherwood@squiz.net>
* @author Marc McIntyre <mmcintyre@squiz.net>
* @copyright 2006-2014 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
/**
* Squiz_Sniffs_ControlStructures_ForEachLoopDeclarationSniff.
*
* Verifies that there is a space between each condition of foreach loops.
*
* @category PHP
* @package PHP_CodeSniffer
* @author Greg Sherwood <gsherwood@squiz.net>
* @author Marc McIntyre <mmcintyre@squiz.net>
* @copyright 2006-2014 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
* @version Release: 1.5.5
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
class Squiz_Sniffs_ControlStructures_ForEachLoopDeclarationSniff implements PHP_CodeSniffer_Sniff
{
/**
* How many spaces should follow the opening bracket.
*
* @var int
*/
public $requiredSpacesAfterOpen = 0;
/**
* How many spaces should precede the closing bracket.
*
* @var int
*/
public $requiredSpacesBeforeClose = 0;
/**
* Returns an array of tokens this test wants to listen for.
*
* @return array
*/
public function register()
{
return array(T_FOREACH);
}//end register()
/**
* Processes this test, when one of its tokens is encountered.
*
* @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
* @param int $stackPtr The position of the current token in the
* stack passed in $tokens.
*
* @return void
*/
public function process(PHP_CodeSniffer_File $phpcsFile, $stackPtr)
{
$this->requiredSpacesAfterOpen = (int) $this->requiredSpacesAfterOpen;
$this->requiredSpacesBeforeClose = (int) $this->requiredSpacesBeforeClose;
$tokens = $phpcsFile->getTokens();
$openingBracket = $phpcsFile->findNext(T_OPEN_PARENTHESIS, $stackPtr);
$closingBracket = $tokens[$openingBracket]['parenthesis_closer'];
if ($this->requiredSpacesAfterOpen === 0 && $tokens[($openingBracket + 1)]['code'] === T_WHITESPACE) {
$error = 'Space found after opening bracket of FOREACH loop';
$phpcsFile->addError($error, $stackPtr, 'SpaceAfterOpen');
} else if ($this->requiredSpacesAfterOpen > 0) {
$spaceAfterOpen = 0;
if ($tokens[($openingBracket + 1)]['code'] === T_WHITESPACE) {
$spaceAfterOpen = strlen($tokens[($openingBracket + 1)]['content']);
}
if ($spaceAfterOpen !== $this->requiredSpacesAfterOpen) {
$error = 'Expected %s spaces after opening bracket; %s found';
$data = array(
$this->requiredSpacesAfterOpen,
$spaceAfterOpen,
);
$phpcsFile->addError($error, $stackPtr, 'SpacingAfterOpen', $data);
}
}
if ($this->requiredSpacesBeforeClose === 0 && $tokens[($closingBracket - 1)]['code'] === T_WHITESPACE) {
$error = 'Space found before closing bracket of FOREACH loop';
$phpcsFile->addError($error, $stackPtr, 'SpaceBeforeClose');
} else if ($this->requiredSpacesBeforeClose > 0) {
$spaceBeforeClose = 0;
if ($tokens[($closingBracket - 1)]['code'] === T_WHITESPACE) {
$spaceBeforeClose = strlen($tokens[($closingBracket - 1)]['content']);
}
if ($spaceBeforeClose !== $this->requiredSpacesBeforeClose) {
$error = 'Expected %s spaces before closing bracket; %s found';
$data = array(
$this->requiredSpacesBeforeClose,
$spaceBeforeClose,
);
$phpcsFile->addError($error, $stackPtr, 'SpaceBeforeClose', $data);
}
}
$asToken = $phpcsFile->findNext(T_AS, $openingBracket);
$content = $tokens[$asToken]['content'];
if ($content !== strtolower($content)) {
$expected = strtolower($content);
$error = 'AS keyword must be lowercase; expected "%s" but found "%s"';
$data = array(
$expected,
$content,
);
$phpcsFile->addError($error, $stackPtr, 'AsNotLower', $data);
}
$doubleArrow = $phpcsFile->findNext(T_DOUBLE_ARROW, $openingBracket, $closingBracket);
if ($doubleArrow !== false) {
if ($tokens[($doubleArrow - 1)]['code'] !== T_WHITESPACE) {
$error = 'Expected 1 space before "=>"; 0 found';
$phpcsFile->addError($error, $stackPtr, 'NoSpaceBeforeArrow');
} else {
if (strlen($tokens[($doubleArrow - 1)]['content']) !== 1) {
$spaces = strlen($tokens[($doubleArrow - 1)]['content']);
$error = 'Expected 1 space before "=>"; %s found';
$data = array($spaces);
$phpcsFile->addError($error, $stackPtr, 'SpacingBeforeArrow', $data);
}
}
if ($tokens[($doubleArrow + 1)]['code'] !== T_WHITESPACE) {
$error = 'Expected 1 space after "=>"; 0 found';
$phpcsFile->addError($error, $stackPtr, 'NoSpaceAfterArrow');
} else {
if (strlen($tokens[($doubleArrow + 1)]['content']) !== 1) {
$spaces = strlen($tokens[($doubleArrow + 1)]['content']);
$error = 'Expected 1 space after "=>"; %s found';
$data = array($spaces);
$phpcsFile->addError($error, $stackPtr, 'SpacingAfterArrow', $data);
}
}
}//end if
if ($tokens[($asToken - 1)]['code'] !== T_WHITESPACE) {
$error = 'Expected 1 space before "as"; 0 found';
$phpcsFile->addError($error, $stackPtr, 'NoSpaceBeforeAs');
} else {
if (strlen($tokens[($asToken - 1)]['content']) !== 1) {
$spaces = strlen($tokens[($asToken - 1)]['content']);
$error = 'Expected 1 space before "as"; %s found';
$data = array($spaces);
$phpcsFile->addError($error, $stackPtr, 'SpacingBeforeAs', $data);
}
}
if ($tokens[($asToken + 1)]['code'] !== T_WHITESPACE) {
$error = 'Expected 1 space after "as"; 0 found';
$phpcsFile->addError($error, $stackPtr, 'NoSpaceAfterAs');
} else {
if (strlen($tokens[($asToken + 1)]['content']) !== 1) {
$spaces = strlen($tokens[($asToken + 1)]['content']);
$error = 'Expected 1 space after "as"; %s found';
$data = array($spaces);
$phpcsFile->addError($error, $stackPtr, 'SpacingAfterAs', $data);
}
}
}//end process()
}//end class