apidoc
[ class tree: apidoc ] [ index: apidoc ] [ all elements ]

Class: Sniff

Source Location: /PHP_CodeSniffer-3.1.1/src/Sniffs/Sniff.php

Class Overview


Represents a PHP_CodeSniffer sniff for sniffing coding standards.


Author(s):

Copyright:

  • 2006-2015 Squiz Pty Ltd (ABN 77 084 670 600)

Methods


Inherited Variables

Inherited Methods


Class Details

[line 19]
Represents a PHP_CodeSniffer sniff for sniffing coding standards.

A sniff registers what token types it wishes to listen for, then, when PHP_CodeSniffer encounters that token, the sniff is invoked and passed information about where the token was found in the stack, and the PHP_CodeSniffer file in which the token was found.



[ Top ]


Method Detail

process   [line 77]

void|int process( File $phpcsFile, int $stackPtr)

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:

  1.     $tokens $phpcsFile->getTokens();
  2.     echo 'Encountered a '.$tokens[$stackPtr]['type'].' token';
  3.     echo 'token information: ';
  4.     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\Files\File object, specifying an error message and the position of the offending token:

  1.     $phpcsFile->addError('Encountered an error'$stackPtr);

  • Return: 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.
  • Access: public

Parameters:

\PHP_CodeSniffer\Files\File   $phpcsFile   —  The PHP_CodeSniffer file where the token was found.
int   $stackPtr   —  The position in the PHP_CodeSniffer file's token stack where the token was found.

[ Top ]

register   [line 40]

int[] register( )

Registers the tokens that this sniff wants to listen for.

An example return value for a sniff that wants to listen for whitespace and any comments would be:

  1.     return array(
  2.             T_WHITESPACE,
  3.             T_DOC_COMMENT,
  4.             T_COMMENT,
  5.            );

  • See: Tokens.php
  • Access: public

[ Top ]


Documentation generated on Mon, 11 Mar 2019 15:27:46 -0400 by phpDocumentor 1.4.4. PEAR Logo Copyright © PHP Group 2004.