$content
".PHP_EOL; + + }//end printTextBlock() + + + /** + * Print a code comparison block found in a standard. + * + * @param DOMNode $node The DOMNode object for the code comparison block. + * + * @return void + */ + protected function printCodeComparisonBlock($node) + { + $codeBlocks = $node->getElementsByTagName('code'); + + $firstTitle = $codeBlocks->item(0)->getAttribute('title'); + $first = trim($codeBlocks->item(0)->nodeValue); + $first = str_replace('', $first); + $first = str_replace(' ', ' ', $first); + $first = str_replace('', '', $first); + $first = str_replace('', '', $first); + + $secondTitle = $codeBlocks->item(1)->getAttribute('title'); + $second = trim($codeBlocks->item(1)->nodeValue); + $second = str_replace('', $second); + $second = str_replace(' ', ' ', $second); + $second = str_replace('', '', $second); + $second = str_replace('', '', $second); + + echo '| $firstTitle | ".PHP_EOL; + echo "$secondTitle | ".PHP_EOL; + echo '
| $first | ".PHP_EOL; + echo "$second | ".PHP_EOL; + echo '
| $firstTitle | ".PHP_EOL; + echo "$secondTitle | ".PHP_EOL; + echo '
|---|---|
| '.PHP_EOL.PHP_EOL; + echo " $first".PHP_EOL.PHP_EOL; + echo ' | '.PHP_EOL; + echo ''.PHP_EOL.PHP_EOL; + echo " $second".PHP_EOL.PHP_EOL; + echo ' | '.PHP_EOL; + echo '
+ * array(
+ * 'code' => 301, // the token type code (see token_get_all())
+ * 'content' => 'if', // the token content
+ * 'type' => 'T_IF', // the token name
+ * 'line' => 56, // the line number when the token is located
+ * 'column' => 12, // the column in the line where this token
+ * // starts (starts from 1)
+ * 'level' => 2 // the depth a token is within the scopes open
+ * 'conditions' => array( // a list of scope condition token
+ * // positions => codes that
+ * 2 => 50, // opened the scopes that this token exists
+ * 9 => 353, // in (see conditional tokens section below)
+ * ),
+ * );
+ *
+ *
+ * Conditional Tokens
+ *
+ * In addition to the standard token fields, conditions contain information to
+ * determine where their scope begins and ends:
+ *
+ *
+ * array(
+ * 'scope_condition' => 38, // the token position of the condition
+ * 'scope_opener' => 41, // the token position that started the scope
+ * 'scope_closer' => 70, // the token position that ended the scope
+ * );
+ *
+ *
+ * The condition, the scope opener and the scope closer each contain this
+ * information.
+ *
+ * Parenthesis Tokens
+ *
+ * Each parenthesis token (T_OPEN_PARENTHESIS and T_CLOSE_PARENTHESIS) has a
+ * reference to their opening and closing parenthesis, one being itself, the
+ * other being its opposite.
+ *
+ *
+ * array(
+ * 'parenthesis_opener' => 34,
+ * 'parenthesis_closer' => 40,
+ * );
+ *
+ *
+ * Some tokens can "own" a set of parenthesis. For example a T_FUNCTION token
+ * has parenthesis around its argument list. These tokens also have the
+ * parenthesis_opener and and parenthesis_closer indices. Not all parenthesis
+ * have owners, for example parenthesis used for arithmetic operations and
+ * function calls. The parenthesis tokens that have an owner have the following
+ * auxiliary array indices.
+ *
+ *
+ * array(
+ * 'parenthesis_opener' => 34,
+ * 'parenthesis_closer' => 40,
+ * 'parenthesis_owner' => 33,
+ * );
+ *
+ *
+ * Each token within a set of parenthesis also has an array index
+ * 'nested_parenthesis' which is an array of the
+ * left parenthesis => right parenthesis token positions.
+ *
+ *
+ * 'nested_parenthesis' => array(
+ * 12 => 15
+ * 11 => 14
+ * );
+ *
+ *
+ * Extended Tokens
+ *
+ * PHP_CodeSniffer extends and augments some of the tokens created by
+ * token_get_all(). A full list of these tokens can be seen in the
+ * Tokens.php file.
+ *
+ * @category PHP
+ * @package PHP_CodeSniffer
+ * @author Greg Sherwood
+ * 0 => array(
+ * 'name' => '$var', // The variable name.
+ * 'pass_by_reference' => false, // Passed by reference.
+ * 'type_hint' => string, // Type hint for array or custom type
+ * )
+ *
+ *
+ * Parameters with default values have an additional array index of
+ * 'default' with the value of the default as a string.
+ *
+ * @param int $stackPtr The position in the stack of the T_FUNCTION token
+ * to acquire the parameters for.
+ *
+ * @return array
+ * @throws PHP_CodeSniffer_Exception If the specified $stackPtr is not of
+ * type T_FUNCTION.
+ */
+ public function getMethodParameters($stackPtr)
+ {
+ if ($this->_tokens[$stackPtr]['code'] !== T_FUNCTION) {
+ throw new PHP_CodeSniffer_Exception('$stackPtr must be of type T_FUNCTION');
+ }
+
+ $opener = $this->_tokens[$stackPtr]['parenthesis_opener'];
+ $closer = $this->_tokens[$stackPtr]['parenthesis_closer'];
+
+ $vars = array();
+ $currVar = null;
+ $defaultStart = null;
+ $paramCount = 0;
+ $passByReference = false;
+ $variableLength = false;
+ $typeHint = '';
+
+ for ($i = ($opener + 1); $i <= $closer; $i++) {
+ // Check to see if this token has a parenthesis or bracket opener. If it does
+ // it's likely to be an array which might have arguments in it. This
+ // could cause problems in our parsing below, so lets just skip to the
+ // end of it.
+ if (isset($this->_tokens[$i]['parenthesis_opener']) === true) {
+ // Don't do this if it's the close parenthesis for the method.
+ if ($i !== $this->_tokens[$i]['parenthesis_closer']) {
+ $i = ($this->_tokens[$i]['parenthesis_closer'] + 1);
+ }
+ }
+
+ if (isset($this->_tokens[$i]['bracket_opener']) === true) {
+ // Don't do this if it's the close parenthesis for the method.
+ if ($i !== $this->_tokens[$i]['bracket_closer']) {
+ $i = ($this->_tokens[$i]['bracket_closer'] + 1);
+ }
+ }
+
+ switch ($this->_tokens[$i]['code']) {
+ case T_BITWISE_AND:
+ $passByReference = true;
+ break;
+ case T_VARIABLE:
+ $currVar = $i;
+ break;
+ case T_ELLIPSIS:
+ $variableLength = true;
+ break;
+ case T_ARRAY_HINT:
+ case T_CALLABLE:
+ $typeHint = $this->_tokens[$i]['content'];
+ break;
+ case T_STRING:
+ // This is a string, so it may be a type hint, but it could
+ // also be a constant used as a default value.
+ $prevComma = false;
+ for ($t = $i; $t >= $opener; $t--) {
+ if ($this->_tokens[$t]['code'] === T_COMMA) {
+ $prevComma = $t;
+ break;
+ }
+ }
+
+ if ($prevComma !== false) {
+ $nextEquals = false;
+ for ($t = $prevComma; $t < $i; $t++) {
+ if ($this->_tokens[$t]['code'] === T_EQUAL) {
+ $nextEquals = $t;
+ break;
+ }
+ }
+
+ if ($nextEquals !== false) {
+ break;
+ }
+ }
+
+ if ($defaultStart === null) {
+ $typeHint .= $this->_tokens[$i]['content'];
+ }
+ break;
+ case T_NS_SEPARATOR:
+ // Part of a type hint or default value.
+ if ($defaultStart === null) {
+ $typeHint .= $this->_tokens[$i]['content'];
+ }
+ break;
+ case T_CLOSE_PARENTHESIS:
+ case T_COMMA:
+ // If it's null, then there must be no parameters for this
+ // method.
+ if ($currVar === null) {
+ continue;
+ }
+
+ $vars[$paramCount] = array();
+ $vars[$paramCount]['name'] = $this->_tokens[$currVar]['content'];
+
+ if ($defaultStart !== null) {
+ $vars[$paramCount]['default']
+ = $this->getTokensAsString(
+ $defaultStart,
+ ($i - $defaultStart)
+ );
+ }
+
+ $vars[$paramCount]['pass_by_reference'] = $passByReference;
+ $vars[$paramCount]['variable_length'] = $variableLength;
+ $vars[$paramCount]['type_hint'] = $typeHint;
+
+ // Reset the vars, as we are about to process the next parameter.
+ $defaultStart = null;
+ $passByReference = false;
+ $variableLength = false;
+ $typeHint = '';
+
+ $paramCount++;
+ break;
+ case T_EQUAL:
+ $defaultStart = ($i + 1);
+ break;
+ }//end switch
+ }//end for
+
+ return $vars;
+
+ }//end getMethodParameters()
+
+
+ /**
+ * Returns the visibility and implementation properties of a method.
+ *
+ * The format of the array is:
+ *
+ * array(
+ * 'scope' => 'public', // public private or protected
+ * 'scope_specified' => true, // true is scope keyword was found.
+ * 'is_abstract' => false, // true if the abstract keyword was found.
+ * 'is_final' => false, // true if the final keyword was found.
+ * 'is_static' => false, // true if the static keyword was found.
+ * 'is_closure' => false, // true if no name is found.
+ * );
+ *
+ *
+ * @param int $stackPtr The position in the stack of the T_FUNCTION token to
+ * acquire the properties for.
+ *
+ * @return array
+ * @throws PHP_CodeSniffer_Exception If the specified position is not a
+ * T_FUNCTION token.
+ */
+ public function getMethodProperties($stackPtr)
+ {
+ if ($this->_tokens[$stackPtr]['code'] !== T_FUNCTION) {
+ throw new PHP_CodeSniffer_Exception('$stackPtr must be of type T_FUNCTION');
+ }
+
+ $valid = array(
+ T_PUBLIC => T_PUBLIC,
+ T_PRIVATE => T_PRIVATE,
+ T_PROTECTED => T_PROTECTED,
+ T_STATIC => T_STATIC,
+ T_FINAL => T_FINAL,
+ T_ABSTRACT => T_ABSTRACT,
+ T_WHITESPACE => T_WHITESPACE,
+ T_COMMENT => T_COMMENT,
+ T_DOC_COMMENT => T_DOC_COMMENT,
+ );
+
+ $scope = 'public';
+ $scopeSpecified = false;
+ $isAbstract = false;
+ $isFinal = false;
+ $isStatic = false;
+ $isClosure = $this->isAnonymousFunction($stackPtr);
+
+ for ($i = ($stackPtr - 1); $i > 0; $i--) {
+ if (isset($valid[$this->_tokens[$i]['code']]) === false) {
+ break;
+ }
+
+ switch ($this->_tokens[$i]['code']) {
+ case T_PUBLIC:
+ $scope = 'public';
+ $scopeSpecified = true;
+ break;
+ case T_PRIVATE:
+ $scope = 'private';
+ $scopeSpecified = true;
+ break;
+ case T_PROTECTED:
+ $scope = 'protected';
+ $scopeSpecified = true;
+ break;
+ case T_ABSTRACT:
+ $isAbstract = true;
+ break;
+ case T_FINAL:
+ $isFinal = true;
+ break;
+ case T_STATIC:
+ $isStatic = true;
+ break;
+ }//end switch
+ }//end for
+
+ return array(
+ 'scope' => $scope,
+ 'scope_specified' => $scopeSpecified,
+ 'is_abstract' => $isAbstract,
+ 'is_final' => $isFinal,
+ 'is_static' => $isStatic,
+ 'is_closure' => $isClosure,
+ );
+
+ }//end getMethodProperties()
+
+
+ /**
+ * Returns the visibility and implementation properties of the class member
+ * variable found at the specified position in the stack.
+ *
+ * The format of the array is:
+ *
+ *
+ * array(
+ * 'scope' => 'public', // public private or protected
+ * 'is_static' => false, // true if the static keyword was found.
+ * );
+ *
+ *
+ * @param int $stackPtr The position in the stack of the T_VARIABLE token to
+ * acquire the properties for.
+ *
+ * @return array
+ * @throws PHP_CodeSniffer_Exception If the specified position is not a
+ * T_VARIABLE token, or if the position is not
+ * a class member variable.
+ */
+ public function getMemberProperties($stackPtr)
+ {
+ if ($this->_tokens[$stackPtr]['code'] !== T_VARIABLE) {
+ throw new PHP_CodeSniffer_Exception('$stackPtr must be of type T_VARIABLE');
+ }
+
+ $conditions = array_keys($this->_tokens[$stackPtr]['conditions']);
+ $ptr = array_pop($conditions);
+ if (isset($this->_tokens[$ptr]) === false
+ || ($this->_tokens[$ptr]['code'] !== T_CLASS
+ && $this->_tokens[$ptr]['code'] !== T_TRAIT)
+ ) {
+ if (isset($this->_tokens[$ptr]) === true
+ && $this->_tokens[$ptr]['code'] === T_INTERFACE
+ ) {
+ // T_VARIABLEs in interfaces can actually be method arguments
+ // but they wont be seen as being inside the method because there
+ // are no scope openers and closers for abstract methods. If it is in
+ // parentheses, we can be pretty sure it is a method argument.
+ if (isset($this->_tokens[$stackPtr]['nested_parenthesis']) === false
+ || empty($this->_tokens[$stackPtr]['nested_parenthesis']) === true
+ ) {
+ $error = 'Possible parse error: interfaces may not include member vars';
+ $this->addWarning($error, $stackPtr, 'Internal.ParseError.InterfaceHasMemberVar');
+ return array();
+ }
+ } else {
+ throw new PHP_CodeSniffer_Exception('$stackPtr is not a class member var');
+ }
+ }
+
+ $valid = array(
+ T_PUBLIC => T_PUBLIC,
+ T_PRIVATE => T_PRIVATE,
+ T_PROTECTED => T_PROTECTED,
+ T_STATIC => T_STATIC,
+ T_WHITESPACE => T_WHITESPACE,
+ T_COMMENT => T_COMMENT,
+ T_DOC_COMMENT => T_DOC_COMMENT,
+ T_VARIABLE => T_VARIABLE,
+ T_COMMA => T_COMMA,
+ );
+
+ $scope = 'public';
+ $scopeSpecified = false;
+ $isStatic = false;
+
+ for ($i = ($stackPtr - 1); $i > 0; $i--) {
+ if (isset($valid[$this->_tokens[$i]['code']]) === false) {
+ break;
+ }
+
+ switch ($this->_tokens[$i]['code']) {
+ case T_PUBLIC:
+ $scope = 'public';
+ $scopeSpecified = true;
+ break;
+ case T_PRIVATE:
+ $scope = 'private';
+ $scopeSpecified = true;
+ break;
+ case T_PROTECTED:
+ $scope = 'protected';
+ $scopeSpecified = true;
+ break;
+ case T_STATIC:
+ $isStatic = true;
+ break;
+ }
+ }//end for
+
+ return array(
+ 'scope' => $scope,
+ 'scope_specified' => $scopeSpecified,
+ 'is_static' => $isStatic,
+ );
+
+ }//end getMemberProperties()
+
+
+ /**
+ * Returns the visibility and implementation properties of a class.
+ *
+ * The format of the array is:
+ *
+ * array(
+ * 'is_abstract' => false, // true if the abstract keyword was found.
+ * 'is_final' => false, // true if the final keyword was found.
+ * );
+ *
+ *
+ * @param int $stackPtr The position in the stack of the T_CLASS token to
+ * acquire the properties for.
+ *
+ * @return array
+ * @throws PHP_CodeSniffer_Exception If the specified position is not a
+ * T_CLASS token.
+ */
+ public function getClassProperties($stackPtr)
+ {
+ if ($this->_tokens[$stackPtr]['code'] !== T_CLASS) {
+ throw new PHP_CodeSniffer_Exception('$stackPtr must be of type T_CLASS');
+ }
+
+ $valid = array(
+ T_FINAL => T_FINAL,
+ T_ABSTRACT => T_ABSTRACT,
+ T_WHITESPACE => T_WHITESPACE,
+ T_COMMENT => T_COMMENT,
+ T_DOC_COMMENT => T_DOC_COMMENT,
+ );
+
+ $isAbstract = false;
+ $isFinal = false;
+
+ for ($i = ($stackPtr - 1); $i > 0; $i--) {
+ if (isset($valid[$this->_tokens[$i]['code']]) === false) {
+ break;
+ }
+
+ switch ($this->_tokens[$i]['code']) {
+ case T_ABSTRACT:
+ $isAbstract = true;
+ break;
+
+ case T_FINAL:
+ $isFinal = true;
+ break;
+ }
+ }//end for
+
+ return array(
+ 'is_abstract' => $isAbstract,
+ 'is_final' => $isFinal,
+ );
+
+ }//end getClassProperties()
+
+
+ /**
+ * Determine if the passed token is a reference operator.
+ *
+ * Returns true if the specified token position represents a reference.
+ * Returns false if the token represents a bitwise operator.
+ *
+ * @param int $stackPtr The position of the T_BITWISE_AND token.
+ *
+ * @return boolean
+ */
+ public function isReference($stackPtr)
+ {
+ if ($this->_tokens[$stackPtr]['code'] !== T_BITWISE_AND) {
+ return false;
+ }
+
+ $tokenBefore = $this->findPrevious(
+ PHP_CodeSniffer_Tokens::$emptyTokens,
+ ($stackPtr - 1),
+ null,
+ true
+ );
+
+ if ($this->_tokens[$tokenBefore]['code'] === T_FUNCTION) {
+ // Function returns a reference.
+ return true;
+ }
+
+ if ($this->_tokens[$tokenBefore]['code'] === T_DOUBLE_ARROW) {
+ // Inside a foreach loop, this is a reference.
+ return true;
+ }
+
+ if ($this->_tokens[$tokenBefore]['code'] === T_AS) {
+ // Inside a foreach loop, this is a reference.
+ return true;
+ }
+
+ if ($this->_tokens[$tokenBefore]['code'] === T_OPEN_SHORT_ARRAY) {
+ // Inside an array declaration, this is a reference.
+ return true;
+ }
+
+ if (isset(PHP_CodeSniffer_Tokens::$assignmentTokens[$this->_tokens[$tokenBefore]['code']]) === true) {
+ // This is directly after an assignment. It's a reference. Even if
+ // it is part of an operation, the other tests will handle it.
+ return true;
+ }
+
+ if (isset($this->_tokens[$stackPtr]['nested_parenthesis']) === true) {
+ $brackets = $this->_tokens[$stackPtr]['nested_parenthesis'];
+ $lastBracket = array_pop($brackets);
+ if (isset($this->_tokens[$lastBracket]['parenthesis_owner']) === true) {
+ $owner = $this->_tokens[$this->_tokens[$lastBracket]['parenthesis_owner']];
+ if ($owner['code'] === T_FUNCTION
+ || $owner['code'] === T_CLOSURE
+ || $owner['code'] === T_ARRAY
+ ) {
+ // Inside a function or array declaration, this is a reference.
+ return true;
+ }
+ } else {
+ $prev = false;
+ for ($t = ($this->_tokens[$lastBracket]['parenthesis_opener'] - 1); $t >= 0; $t--) {
+ if ($this->_tokens[$t]['code'] !== T_WHITESPACE) {
+ $prev = $t;
+ break;
+ }
+ }
+
+ if ($prev !== false && $this->_tokens[$prev]['code'] === T_USE) {
+ return true;
+ }
+ }//end if
+ }//end if
+
+ $tokenAfter = $this->findNext(
+ PHP_CodeSniffer_Tokens::$emptyTokens,
+ ($stackPtr + 1),
+ null,
+ true
+ );
+
+ if ($this->_tokens[$tokenAfter]['code'] === T_VARIABLE
+ && ($this->_tokens[$tokenBefore]['code'] === T_OPEN_PARENTHESIS
+ || $this->_tokens[$tokenBefore]['code'] === T_COMMA)
+ ) {
+ return true;
+ }
+
+ return false;
+
+ }//end isReference()
+
+
+ /**
+ * Returns the content of the tokens from the specified start position in
+ * the token stack for the specified length.
+ *
+ * @param int $start The position to start from in the token stack.
+ * @param int $length The length of tokens to traverse from the start pos.
+ *
+ * @return string The token contents.
+ */
+ public function getTokensAsString($start, $length)
+ {
+ $str = '';
+ $end = ($start + $length);
+ if ($end > $this->numTokens) {
+ $end = $this->numTokens;
+ }
+
+ for ($i = $start; $i < $end; $i++) {
+ $str .= $this->_tokens[$i]['content'];
+ }
+
+ return $str;
+
+ }//end getTokensAsString()
+
+
+ /**
+ * Returns the position of the next specified token(s).
+ *
+ * If a value is specified, the next token of the specified type(s)
+ * containing the specified value will be returned.
+ *
+ * Returns false if no token can be found.
+ *
+ * @param int|array $types The type(s) of tokens to search for.
+ * @param int $start The position to start searching from in the
+ * token stack.
+ * @param int $end The end position to fail if no token is found.
+ * if not specified or null, end will default to
+ * the start of the token stack.
+ * @param bool $exclude If true, find the next token that are NOT of
+ * the types specified in $types.
+ * @param string $value The value that the token(s) must be equal to.
+ * If value is omitted, tokens with any value will
+ * be returned.
+ * @param bool $local If true, tokens outside the current statement
+ * will not be checked. IE. checking will stop
+ * at the next semi-colon found.
+ *
+ * @return int|bool
+ * @see findNext()
+ */
+ public function findPrevious(
+ $types,
+ $start,
+ $end=null,
+ $exclude=false,
+ $value=null,
+ $local=false
+ ) {
+ $types = (array) $types;
+
+ if ($end === null) {
+ $end = 0;
+ }
+
+ for ($i = $start; $i >= $end; $i--) {
+ $found = (bool) $exclude;
+ foreach ($types as $type) {
+ if ($this->_tokens[$i]['code'] === $type) {
+ $found = !$exclude;
+ break;
+ }
+ }
+
+ if ($found === true) {
+ if ($value === null) {
+ return $i;
+ } else if ($this->_tokens[$i]['content'] === $value) {
+ return $i;
+ }
+ }
+
+ if ($local === true) {
+ if (isset($this->_tokens[$i]['scope_opener']) === true
+ && $i === $this->_tokens[$i]['scope_closer']
+ ) {
+ $i = $this->_tokens[$i]['scope_opener'];
+ } else if (isset($this->_tokens[$i]['bracket_opener']) === true
+ && $i === $this->_tokens[$i]['bracket_closer']
+ ) {
+ $i = $this->_tokens[$i]['bracket_opener'];
+ } else if (isset($this->_tokens[$i]['parenthesis_opener']) === true
+ && $i === $this->_tokens[$i]['parenthesis_closer']
+ ) {
+ $i = $this->_tokens[$i]['parenthesis_opener'];
+ } else if ($this->_tokens[$i]['code'] === T_SEMICOLON) {
+ break;
+ }
+ }
+ }//end for
+
+ return false;
+
+ }//end findPrevious()
+
+
+ /**
+ * Returns the position of the next specified token(s).
+ *
+ * If a value is specified, the next token of the specified type(s)
+ * containing the specified value will be returned.
+ *
+ * Returns false if no token can be found.
+ *
+ * @param int|array $types The type(s) of tokens to search for.
+ * @param int $start The position to start searching from in the
+ * token stack.
+ * @param int $end The end position to fail if no token is found.
+ * if not specified or null, end will default to
+ * the end of the token stack.
+ * @param bool $exclude If true, find the next token that is NOT of
+ * a type specified in $types.
+ * @param string $value The value that the token(s) must be equal to.
+ * If value is omitted, tokens with any value will
+ * be returned.
+ * @param bool $local If true, tokens outside the current statement
+ * will not be checked. i.e., checking will stop
+ * at the next semi-colon found.
+ *
+ * @return int|bool
+ * @see findPrevious()
+ */
+ public function findNext(
+ $types,
+ $start,
+ $end=null,
+ $exclude=false,
+ $value=null,
+ $local=false
+ ) {
+ $types = (array) $types;
+
+ if ($end === null || $end > $this->numTokens) {
+ $end = $this->numTokens;
+ }
+
+ for ($i = $start; $i < $end; $i++) {
+ $found = (bool) $exclude;
+ foreach ($types as $type) {
+ if ($this->_tokens[$i]['code'] === $type) {
+ $found = !$exclude;
+ break;
+ }
+ }
+
+ if ($found === true) {
+ if ($value === null) {
+ return $i;
+ } else if ($this->_tokens[$i]['content'] === $value) {
+ return $i;
+ }
+ }
+
+ if ($local === true && $this->_tokens[$i]['code'] === T_SEMICOLON) {
+ break;
+ }
+ }//end for
+
+ return false;
+
+ }//end findNext()
+
+
+ /**
+ * Returns the position of the first non-whitespace token in a statement.
+ *
+ * @param int $start The position to start searching from in the token stack.
+ *
+ * @return int
+ */
+ public function findStartOfStatement($start)
+ {
+ $endTokens = PHP_CodeSniffer_Tokens::$blockOpeners;
+
+ $endTokens[T_COLON] = true;
+ $endTokens[T_COMMA] = true;
+ $endTokens[T_DOUBLE_ARROW] = true;
+ $endTokens[T_SEMICOLON] = true;
+ $endTokens[T_OPEN_TAG] = true;
+ $endTokens[T_CLOSE_TAG] = true;
+ $endTokens[T_OPEN_SHORT_ARRAY] = true;
+
+ $lastNotEmpty = $start;
+
+ for ($i = $start; $i >= 0; $i--) {
+ if (isset($endTokens[$this->_tokens[$i]['code']]) === true) {
+ // Found the end of the previous statement.
+ return $lastNotEmpty;
+ }
+
+ if (isset($this->_tokens[$i]['scope_opener']) === true
+ && $i === $this->_tokens[$i]['scope_closer']
+ ) {
+ // Found the end of the previous scope block.
+ return $lastNotEmpty;
+ }
+
+ // Skip nested statements.
+ if (isset($this->_tokens[$i]['bracket_opener']) === true
+ && $i === $this->_tokens[$i]['bracket_closer']
+ ) {
+ $i = $this->_tokens[$i]['bracket_opener'];
+ } else if (isset($this->_tokens[$i]['parenthesis_opener']) === true
+ && $i === $this->_tokens[$i]['parenthesis_closer']
+ ) {
+ $i = $this->_tokens[$i]['parenthesis_opener'];
+ }
+
+ if (isset(PHP_CodeSniffer_Tokens::$emptyTokens[$this->_tokens[$i]['code']]) === false) {
+ $lastNotEmpty = $i;
+ }
+ }//end for
+
+ return 0;
+
+ }//end findStartOfStatement()
+
+
+ /**
+ * Returns the position of the last non-whitespace token in a statement.
+ *
+ * @param int $start The position to start searching from in the token stack.
+ *
+ * @return int
+ */
+ public function findEndOfStatement($start)
+ {
+ $endTokens = array(
+ T_COLON => true,
+ T_COMMA => true,
+ T_DOUBLE_ARROW => true,
+ T_SEMICOLON => true,
+ T_CLOSE_PARENTHESIS => true,
+ T_CLOSE_SQUARE_BRACKET => true,
+ T_CLOSE_CURLY_BRACKET => true,
+ T_CLOSE_SHORT_ARRAY => true,
+ T_OPEN_TAG => true,
+ T_CLOSE_TAG => true,
+ );
+
+ $lastNotEmpty = $start;
+
+ for ($i = $start; $i < $this->numTokens; $i++) {
+ if ($i !== $start && isset($endTokens[$this->_tokens[$i]['code']]) === true) {
+ // Found the end of the statement.
+ if ($this->_tokens[$i]['code'] === T_CLOSE_PARENTHESIS
+ || $this->_tokens[$i]['code'] === T_CLOSE_SQUARE_BRACKET
+ || $this->_tokens[$i]['code'] === T_CLOSE_CURLY_BRACKET
+ || $this->_tokens[$i]['code'] === T_OPEN_TAG
+ || $this->_tokens[$i]['code'] === T_CLOSE_TAG
+ ) {
+ return $lastNotEmpty;
+ }
+
+ return $i;
+ }
+
+ // Skip nested statements.
+ if (isset($this->_tokens[$i]['scope_closer']) === true
+ && ($i === $this->_tokens[$i]['scope_opener']
+ || $i === $this->_tokens[$i]['scope_condition'])
+ ) {
+ $i = $this->_tokens[$i]['scope_closer'];
+ } else if (isset($this->_tokens[$i]['bracket_closer']) === true
+ && $i === $this->_tokens[$i]['bracket_opener']
+ ) {
+ $i = $this->_tokens[$i]['bracket_closer'];
+ } else if (isset($this->_tokens[$i]['parenthesis_closer']) === true
+ && $i === $this->_tokens[$i]['parenthesis_opener']
+ ) {
+ $i = $this->_tokens[$i]['parenthesis_closer'];
+ }
+
+ if (isset(PHP_CodeSniffer_Tokens::$emptyTokens[$this->_tokens[$i]['code']]) === false) {
+ $lastNotEmpty = $i;
+ }
+ }//end for
+
+ return ($this->numTokens - 1);
+
+ }//end findEndOfStatement()
+
+
+ /**
+ * Returns the position of the first token on a line, matching given type.
+ *
+ * Returns false if no token can be found.
+ *
+ * @param int|array $types The type(s) of tokens to search for.
+ * @param int $start The position to start searching from in the
+ * token stack. The first token matching on
+ * this line before this token will be returned.
+ * @param bool $exclude If true, find the token that is NOT of
+ * the types specified in $types.
+ * @param string $value The value that the token must be equal to.
+ * If value is omitted, tokens with any value will
+ * be returned.
+ *
+ * @return int | bool
+ */
+ public function findFirstOnLine($types, $start, $exclude=false, $value=null)
+ {
+ if (is_array($types) === false) {
+ $types = array($types);
+ }
+
+ $foundToken = false;
+
+ for ($i = $start; $i >= 0; $i--) {
+ if ($this->_tokens[$i]['line'] < $this->_tokens[$start]['line']) {
+ break;
+ }
+
+ $found = $exclude;
+ foreach ($types as $type) {
+ if ($exclude === false) {
+ if ($this->_tokens[$i]['code'] === $type) {
+ $found = true;
+ break;
+ }
+ } else {
+ if ($this->_tokens[$i]['code'] === $type) {
+ $found = false;
+ break;
+ }
+ }
+ }
+
+ if ($found === true) {
+ if ($value === null) {
+ $foundToken = $i;
+ } else if ($this->_tokens[$i]['content'] === $value) {
+ $foundToken = $i;
+ }
+ }
+ }//end for
+
+ return $foundToken;
+
+ }//end findFirstOnLine()
+
+
+ /**
+ * Determine if the passed token has a condition of one of the passed types.
+ *
+ * @param int $stackPtr The position of the token we are checking.
+ * @param int|array $types The type(s) of tokens to search for.
+ *
+ * @return boolean
+ */
+ public function hasCondition($stackPtr, $types)
+ {
+ // Check for the existence of the token.
+ if (isset($this->_tokens[$stackPtr]) === false) {
+ return false;
+ }
+
+ // Make sure the token has conditions.
+ if (isset($this->_tokens[$stackPtr]['conditions']) === false) {
+ return false;
+ }
+
+ $types = (array) $types;
+ $conditions = $this->_tokens[$stackPtr]['conditions'];
+
+ foreach ($types as $type) {
+ if (in_array($type, $conditions) === true) {
+ // We found a token with the required type.
+ return true;
+ }
+ }
+
+ return false;
+
+ }//end hasCondition()
+
+
+ /**
+ * Return the position of the condition for the passed token.
+ *
+ * Returns FALSE if the token does not have the condition.
+ *
+ * @param int $stackPtr The position of the token we are checking.
+ * @param int $type The type of token to search for.
+ *
+ * @return int
+ */
+ public function getCondition($stackPtr, $type)
+ {
+ // Check for the existence of the token.
+ if (isset($this->_tokens[$stackPtr]) === false) {
+ return false;
+ }
+
+ // Make sure the token has conditions.
+ if (isset($this->_tokens[$stackPtr]['conditions']) === false) {
+ return false;
+ }
+
+ $conditions = $this->_tokens[$stackPtr]['conditions'];
+ foreach ($conditions as $token => $condition) {
+ if ($condition === $type) {
+ return $token;
+ }
+ }
+
+ return false;
+
+ }//end getCondition()
+
+
+ /**
+ * Returns the name of the class that the specified class extends.
+ *
+ * Returns FALSE on error or if there is no extended class name.
+ *
+ * @param int $stackPtr The stack position of the class.
+ *
+ * @return string
+ */
+ public function findExtendedClassName($stackPtr)
+ {
+ // Check for the existence of the token.
+ if (isset($this->_tokens[$stackPtr]) === false) {
+ return false;
+ }
+
+ if ($this->_tokens[$stackPtr]['code'] !== T_CLASS) {
+ return false;
+ }
+
+ if (isset($this->_tokens[$stackPtr]['scope_closer']) === false) {
+ return false;
+ }
+
+ $classCloserIndex = $this->_tokens[$stackPtr]['scope_closer'];
+ $extendsIndex = $this->findNext(T_EXTENDS, $stackPtr, $classCloserIndex);
+ if (false === $extendsIndex) {
+ return false;
+ }
+
+ $find = array(
+ T_NS_SEPARATOR,
+ T_STRING,
+ T_WHITESPACE,
+ );
+
+ $end = $this->findNext($find, ($extendsIndex + 1), $classCloserIndex, true);
+ $name = $this->getTokensAsString(($extendsIndex + 1), ($end - $extendsIndex - 1));
+ $name = trim($name);
+
+ if ($name === '') {
+ return false;
+ }
+
+ return $name;
+
+ }//end findExtendedClassName()
+
+
+}//end class
Index: /lib/shariff-backend-php-master/vendor/squizlabs/php_codesniffer/CodeSniffer/Fixer.php
===================================================================
--- /lib/shariff-backend-php-master/vendor/squizlabs/php_codesniffer/CodeSniffer/Fixer.php (revision 5534)
+++ /lib/shariff-backend-php-master/vendor/squizlabs/php_codesniffer/CodeSniffer/Fixer.php (revision 5534)
@@ -0,0 +1,699 @@
+
+ * @copyright 2006-2012 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
+ */
+
+/**
+ * A helper class for fixing errors.
+ *
+ * Provides helper functions that act upon a token array and modify the file
+ * content.
+ *
+ * @category PHP
+ * @package PHP_CodeSniffer
+ * @author Greg Sherwood
+ * return array(
+ * T_WHITESPACE,
+ * T_DOC_COMMENT,
+ * T_COMMENT,
+ * );
+ *
+ *
+ * @return int[]
+ * @see Tokens.php
+ */
+ public function register();
+
+
+ /**
+ * Called when one of the token types that this sniff is listening for
+ * is found.
+ *
+ * The stackPtr variable indicates where in the stack the token was found.
+ * A sniff can acquire information this token, along with all the other
+ * tokens within the stack by first acquiring the token stack:
+ *
+ *
+ * $tokens = $phpcsFile->getTokens();
+ * echo 'Encountered a '.$tokens[$stackPtr]['type'].' token';
+ * echo 'token information: ';
+ * print_r($tokens[$stackPtr]);
+ *
+ *
+ * If the sniff discovers an anomaly in the code, they can raise an error
+ * by calling addError() on the PHP_CodeSniffer_File object, specifying an error
+ * message and the position of the offending token:
+ *
+ *
+ * $phpcsFile->addError('Encountered an error', $stackPtr);
+ *
+ *
+ * @param PHP_CodeSniffer_File $phpcsFile The PHP_CodeSniffer file where the
+ * token was found.
+ * @param int $stackPtr The position in the PHP_CodeSniffer
+ * file's token stack where the token
+ * was found.
+ *
+ * @return void|int Optionally returns a stack pointer. The sniff will not be
+ * called again on the current file until the returned stack
+ * pointer is reached. Return (count($tokens) + 1) to skip
+ * the rest of the file.
+ */
+ public function process(PHP_CodeSniffer_File $phpcsFile, $stackPtr);
+
+
+}//end interface
Index: /lib/shariff-backend-php-master/vendor/squizlabs/php_codesniffer/CodeSniffer/Standards/AbstractPatternSniff.php
===================================================================
--- /lib/shariff-backend-php-master/vendor/squizlabs/php_codesniffer/CodeSniffer/Standards/AbstractPatternSniff.php (revision 5534)
+++ /lib/shariff-backend-php-master/vendor/squizlabs/php_codesniffer/CodeSniffer/Standards/AbstractPatternSniff.php (revision 5534)
@@ -0,0 +1,962 @@
+
+ * @author Marc McIntyre
+ * array(
+ * T_WHITESPACE => 0, // 0 is the position where the T_WHITESPACE token
+ * // should occur in the pattern.
+ * );
+ *
+ *
+ * @param array $pattern The parsed pattern to find the acquire the token
+ * types from.
+ *
+ * @return array
+ * class ClassScopeTest extends PHP_CodeSniffer_Standards_AbstractScopeSniff
+ * {
+ * public function __construct()
+ * {
+ * parent::__construct(array(T_CLASS), array(T_FUNCTION));
+ * }
+ *
+ * protected function processTokenWithinScope(PHP_CodeSniffer_File $phpcsFile, $)
+ * {
+ * $className = $phpcsFile->getDeclarationName($currScope);
+ * echo 'encountered a method within class '.$className;
+ * }
+ * }
+ *
+ *
+ * @category PHP
+ * @package PHP_CodeSniffer
+ * @author Greg Sherwood
+ Foo
+{
+}
+ ]]>
+
+
+ Foo
+{
+}
+
+class Foo
+{
+}
+ ]]>
+
+
+
+
+
+ // do nothing
+}
+ ]]>
+
+
+ $i = 0; $i < 10; $i++) {
+ echo "{$i}\n";
+}
+ ]]>
+
+
+ ;$test;) {
+ $test = doSomething();
+}
+ ]]>
+
+
+ $end = count($foo);
+for ($i = 0; $i < $end; $i++) {
+ echo $foo[$i]."\n";
+}
+ ]]>
+
+
+ count($foo); $i++) {
+ echo $foo[$i]."\n";
+}
+ ]]>
+
+
+ $i++) {
+ for ($j = 0; $j < 10; $j++) {
+ }
+}
+ ]]>
+
+
+ $i++) {
+ for ($j = 0; $j < 10; $i++) {
+ }
+}
+ ]]>
+
+
+ $test) {
+ $var = 1;
+}
+ ]]>
+
+
+ true) {
+ $var = 1;
+}
+ ]]>
+
+
+ $test) {
+ $var = 1;
+}
+ ]]>
+
+
+ false) {
+ $var = 1;
+}
+ ]]>
+
+
+
+
+
+ final function bar()
+ {
+ }
+}
+ ]]>
+
+
+ $a + $b + $c;
+}
+ ]]>
+
+
+ $a + $b;
+}
+ ]]>
+
+
+ $this->doSomethingElse();
+ }
+}
+ ]]>
+
+
+ parent::bar();
+ }
+}
+ ]]>
+
+
+ Handle strange case
+if ($test) {
+ $var = 1;
+}
+ ]]>
+
+
+ FIXME: This needs to be fixed!
+if ($test) {
+ $var = 1;
+}
+ ]]>
+
+
+ Handle strange case
+if ($test) {
+ $var = 1;
+}
+ ]]>
+
+
+ TODO: This needs to be fixed!
+if ($test) {
+ $var = 1;
+}
+ ]]>
+
+
+ {
+ $var = 1;
+}
+ ]]>
+
+
+
+
+
+ %; }
+ ]]>
+
+
+ %; }
+ ]]>
+
+
+ ];
+ ]]>
+
+
+ ,];
+ ]]>
+
+
+ var foo = 5;
+ ]]>
+
+
+ foo = 5;
+ ]]>
+
+
+
+
+
+ some string here
+
+
+
+ class Foo
+{
+}
+ ]]>
+
+
+ class Foo
+{
+}
+
+class Bar
+{
+}
+ ]]>
+
+
+ interface Foo
+{
+}
+ ]]>
+
+
+ interface Foo
+{
+}
+
+interface Bar
+{
+}
+ ]]>
+
+
+
+
+
+
+
+
+ = (1 + 2);
+$veryLongVarName = 'string';
+$var = foo($bar, $baz, $quux);
+ ]]>
+
+
+ = (1 + 2);
+$veryLongVarName = 'string';
+$var = foo($bar, $baz, $quux);
+ ]]>
+
+
+ += 1;
+$veryLongVarName = 1;
+ ]]>
+
+
+ += 1;
+$veryLongVarName = 1;
+ ]]>
+
+
+ = 1;
+$veryLongVarName -= 1;
+ ]]>
+
+
+ = 1;
+$veryLongVarName -= 1;
+ ]]>
+
+
+
+
+
+ 1;
+ ]]>
+
+
+ 1;
+ ]]>
+
+
+ 1;
+ ]]>
+
+
+ &$bar)
+{
+ $bar++;
+}
+
+$baz = 1;
+foo($baz);
+ ]]>
+
+
+ &$baz);
+ ]]>
+
+
+ $baz)
+{
+}
+ ]]>
+
+
+ $baz)
+{
+}
+ ]]>
+
+
+ = true)
+{
+}
+ ]]>
+
+
+ =true)
+{
+}
+ ]]>
+
+
+ {
+ ...
+}
+ ]]>
+
+
+ {
+ ...
+}
+ ]]>
+
+
+ {
+ ...
+}
+ ]]>
+
+
+ {
+ ...
+}
+ ]]>
+
+
+ doSomething()
+{
+}
+ ]]>
+
+
+ do_something()
+{
+}
+ ]]>
+
+
+ __construct()
+ {
+ }
+}
+ ]]>
+
+
+ Foo()
+ {
+ }
+}
+ ]]>
+
+
+ FOO_CONSTANT', 'foo');
+
+class FooClass
+{
+ const FOO_CONSTANT = 'foo';
+}
+ ]]>
+
+
+ Foo_Constant', 'foo');
+
+class FooClass
+{
+ const foo_constant = 'foo';
+}
+ ]]>
+
+
+
+
+
+ Beginning content
+
+
+
+
+echo 'Foo';
+?>
+ ]]>
+
+
+
+echo 'Foo';
+ ]]>
+
+
+ explode('a', $bar);
+ ]]>
+
+
+ split('a', $bar);
+ ]]>
+
+
+ count($bar);
+ ]]>
+
+
+ sizeof($bar);
+ ]]>
+
+
+ false || $var === null) {
+ $var = true;
+}
+ ]]>
+
+
+ FALSE || $var === NULL) {
+ $var = TRUE;
+}
+ ]]>
+
+
+ array();
+ ]]>
+
+
+ Array();
+ ]]>
+
+
+ isset($foo) && $foo) {
+ echo "Hello\n";
+}
+ ]]>
+
+
+ @$foo) {
+ echo "Hello\n";
+}
+ ]]>
+
+
+ PHP_SAPI === 'cli') {
+ echo "Hello, CLI user.";
+}
+ ]]>
+
+
+ php_sapi_name() === 'cli') {
+ echo "Hello, CLI user.";
+}
+ ]]>
+
+
+ FALSE || $var === NULL) {
+ $var = TRUE;
+}
+ ]]>
+
+
+ false || $var === null) {
+ $var = true;
+}
+ ]]>
+
+
+
+
+
+
+
+
+ $var = 1;
+}
+ ]]>
+
+
+ $var = 1;
+}
+ ]]>
+
+
+ * stmt {
+ * // foo
+ * }
+ * stmt (conditions) {
+ * // foo
+ * }
+ *
+ *
+ * @category PHP
+ * @package PHP_CodeSniffer
+ * @author Manuel Pichler
+ * class Foo
+ * {
+ * public function bar($x)
+ * {
+ * for (;true;) true; // No Init or Update part, may as well be: while (true)
+ * }
+ * }
+ *
+ *
+ * @category PHP
+ * @package PHP_CodeSniffer
+ * @author Manuel Pichler
+ * class Foo
+ * {
+ * public function bar($x)
+ * {
+ * $a = array(1, 2, 3, 4);
+ * for ($i = 0; $i < count($a); $i++) {
+ * $a[$i] *= $i;
+ * }
+ * }
+ * }
+ *
+ *
+ * @category PHP
+ * @package PHP_CodeSniffer
+ * @author Manuel Pichler
+ * class Foo
+ * {
+ * public function bar($x)
+ * {
+ * for ($i = 0; $i < 10; $i++)
+ * {
+ * for ($k = 0; $k < 20; $i++)
+ * {
+ * echo 'Hello';
+ * }
+ * }
+ * }
+ * }
+ *
+ *
+ * @category PHP
+ * @package PHP_CodeSniffer
+ * @author Manuel Pichler
+ * class Foo
+ * {
+ * public function close()
+ * {
+ * if (true)
+ * {
+ * // ...
+ * }
+ * }
+ * }
+ *
+ *
+ * @category PHP
+ * @package PHP_CodeSniffer
+ * @author Manuel Pichler
+ * final class Foo
+ * {
+ * public final function bar()
+ * {
+ * }
+ * }
+ *
+ *
+ * @category PHP
+ * @package PHP_CodeSniffer
+ * @author Manuel Pichler
+ * class FooBar {
+ * public function __construct($a, $b) {
+ * parent::__construct($a, $b);
+ * }
+ * }
+ *
+ *
+ * @category PHP
+ * @package PHP_CodeSniffer
+ * @author Manuel Pichler