Docs For Class PHP_CodeSniffer_Standards

Class: PHP_CodeSniffer_Standards_AbstractScopeSniff

Class Overview

An AbstractScopeTest allows for tests that extend from this class to listen for tokens within a particluar scope.

Author(s):

Marc McIntyre <mmcintyre at squiz.net>
Greg Sherwood <gsherwood at squiz.net>

Version:

Release: 1.3.4

Copyright:

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

Methods

Class Details

[line 47]
An AbstractScopeTest allows for tests that extend from this class to listen for tokens within a particluar scope.

Below is a test that listens to methods that exist only within classes:

 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;
     }
 }

Author: Marc McIntyre <mmcintyre@squiz.net>
Author: Greg Sherwood <gsherwood@squiz.net>
Version: Release: 1.3.4
Copyright: 2006-2011 Squiz Pty Ltd (ABN 77 084 670 600)
Link: http://pear.php.net/package/PHP_CodeSniffer
Abstract:
License: BSD Licence

Method Detail

__construct (Constructor) [line 86]

PHP_CodeSniffer_Standards_AbstractScopeSniff __construct(

$scopeTokens, 
$tokens, [boolean
$listenOutside = false])

Constructs a new AbstractScopeTest.

See: PHP_CodeSniffer.getValidScopeTokeners()
Throws: PHP_CodeSniffer_Exception If the specified tokens array is empty.
Access: public

Overridden in child classes as:

PHP_CodeSniffer_Standards_AbstractVariableSniff::__construct(): Constructs an AbstractVariableTest.

MySource_Sniffs_Channels_IncludeSystemSniff::__construct(): Constructs a Squiz_Sniffs_Scope_MethodScopeSniff.

Generic_Sniffs_NamingConventions_ConstructorNameSniff::__construct(): Constructs the test with the tokens it wishes to listen for.

Squiz_Sniffs_Commenting_FunctionCommentThrowTagSniff::__construct(): Constructs a Squiz_Sniffs_Commenting_FunctionCommentThrowTagSniff.

Squiz_Sniffs_Scope_MethodScopeSniff::__construct(): Constructs a Squiz_Sniffs_Scope_MethodScopeSniff.

Squiz_Sniffs_Scope_StaticThisUsageSniff::__construct(): Constructs the test with the tokens it wishes to listen for.

Squiz_Sniffs_Classes_SelfMemberReferenceSniff::__construct(): Constructs a Squiz_Sniffs_Classes_SelfMemberReferenceSniff.

PEAR_Sniffs_NamingConventions_ValidFunctionNameSniff::__construct(): Constructs a PEAR_Sniffs_NamingConventions_ValidFunctionNameSniff.

Parameters:

array	`$scopeTokens`	—	The type of scope the test wishes to listen to.
array	`$tokens`	—	The tokens that the test wishes to listen to within the scope.
boolean	`$listenOutside`	—	If true this test will also alert the extending class when a token is found outside the scope, by calling the processTokenOutideScope method.

[ Top ]

process [line 142]

void process(
PHP_CodeSniffer_File
$phpcsFile, int
$stackPtr)

Processes the tokens that this test is listening for.

See: PHP_CodeSniffer_Standards_AbstractScopeSniff::processTokenWithinScope()
Access: public

Parameters:

PHP_CodeSniffer_File	`$phpcsFile`	—	The file where this token was found.
int	`$stackPtr`	—	The position in the stack where this token was found.

[ Top ]

processTokenOutsideScope [line 191]

void processTokenOutsideScope(
PHP_CodeSniffer_File
$phpcsFile, int
$stackPtr)

Processes a token that is found within the scope that this test is listening to.

Access: protected

Overridden in child classes as:

PHP_CodeSniffer_Standards_AbstractVariableSniff::processTokenOutsideScope(): Processes the token outside the scope in the file.

MySource_Sniffs_Channels_IncludeSystemSniff::processTokenOutsideScope(): Processes a token within the scope that this test is listening to.

PEAR_Sniffs_NamingConventions_ValidFunctionNameSniff::processTokenOutsideScope(): Processes the tokens outside the scope.

Squiz_Sniffs_NamingConventions_ValidFunctionNameSniff::processTokenOutsideScope(): Processes the tokens outside the scope.

Parameters:

PHP_CodeSniffer_File	`$phpcsFile`	—	The file where this token was found.
int	`$stackPtr`	—	The position in the stack where this token was found.

[ Top ]

processTokenWithinScope [line 174]

void processTokenWithinScope(
PHP_CodeSniffer_File
$phpcsFile, int
$stackPtr, int
$currScope)

Processes a token that is found within the scope that this test is listening to.

Abstract:
Access: protected

Overridden in child classes as:

PHP_CodeSniffer_Standards_AbstractVariableSniff::processTokenWithinScope(): Processes the token in the specified PHP_CodeSniffer_File.

MySource_Sniffs_Channels_IncludeSystemSniff::processTokenWithinScope(): Processes the function tokens within the class.

Generic_Sniffs_NamingConventions_ConstructorNameSniff::processTokenWithinScope(): Processes this test when one of its tokens is encountered.

Squiz_Sniffs_Commenting_FunctionCommentThrowTagSniff::processTokenWithinScope(): Processes the function tokens within the class.

Squiz_Sniffs_Scope_MethodScopeSniff::processTokenWithinScope(): Processes the function tokens within the class.

Squiz_Sniffs_Scope_StaticThisUsageSniff::processTokenWithinScope(): Processes this test, when one of its tokens is encountered.

Squiz_Sniffs_Classes_SelfMemberReferenceSniff::processTokenWithinScope(): Processes the function tokens within the class.

PEAR_Sniffs_NamingConventions_ValidFunctionNameSniff::processTokenWithinScope(): Processes the tokens within the scope.

Parameters:

PHP_CodeSniffer_File	`$phpcsFile`	—	The file where this token was found.
int	`$stackPtr`	—	The position in the stack where this token was found.
int	`$currScope`	—	The position in the tokens array that opened the scope that this test is listening for.

[ Top ]

register [line 125]

array(int) register(
)

The method that is called to register the tokens this test wishes to listen to.

DO NOT OVERRIDE THIS METHOD. Use the constructor of this class to register for the desired tokens and scope.

See: __constructor()
Access: public

[ Top ]

Class: PHP_CodeSniffer_Standards_AbstractScopeSniff

Class Overview

Author(s):

Version:

Copyright:

Methods

Child classes:

Inherited Variables

Inherited Methods

Class Details

Method Detail

__construct (Constructor) [line 86]

Parameters:

process [line 142]

Parameters:

processTokenOutsideScope [line 191]

Parameters:

processTokenWithinScope [line 174]

Parameters:

register [line 125]