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

Class: PHP_CodeSniffer_Standards_AbstractScopeSniff

Source Location: /PHP_CodeSniffer-1.2.0/CodeSniffer/Standards/AbstractScopeSniff.php

Class Overview


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


Author(s):

Version:

  • Release: 1.2.0

Copyright:

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

Variables

Methods


Child classes:

PHP_CodeSniffer_Standards_AbstractVariableSniff
A class to find T_VARIABLE tokens.
MySource_Sniffs_Channels_IncludeSystemSniff
Ensures that systems, asset types and libs are included before they are used.
Generic_Sniffs_NamingConventions_ConstructorNameSniff
Generic_Sniffs_NamingConventions_ConstructorNameSniff.
Squiz_Sniffs_Commenting_FunctionCommentThrowTagSniff
Verifies that a @throws tag exists for a function that throws exceptions.
Squiz_Sniffs_Scope_MethodScopeSniff
Verifies that class members have scope modifiers.
Squiz_Sniffs_Scope_StaticThisUsageSniff
Squiz_Sniffs_Scope_StaticThisUsageSniff.
Squiz_Sniffs_Classes_SelfMemberReferenceSniff
Tests self member references.
PEAR_Sniffs_NamingConventions_ValidFunctionNameSniff
PEAR_Sniffs_NamingConventions_ValidFunctionNameSniff.

Inherited Variables

Inherited Methods


Class Details

[line 48]
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:

  1.  class ClassScopeTest extends PHP_CodeSniffer_Standards_AbstractScopeSniff
  2.  {
  3.      public function __construct()
  4.      {
  5.          parent::__construct(array(T_CLASS)array(T_FUNCTION));
  6.      }
  7.  
  8.      protected function processTokenWithinScope(PHP_CodeSniffer_File $phpcsFile$)
  9.      {
  10.          $className $phpcsFile->getDeclarationName($currScope);
  11.          echo 'encountered a method within class '.$className;
  12.      }
  13.  }



[ Top ]


Class Variables

$currFile =  ''

[line 77]

The current file being checked.
  • Access: protected

Type:   string


[ Top ]

$currScope =  null

[line 70]

The position in the tokens array that opened the current scope.
  • Access: protected

Type:   array()


[ Top ]



Method Detail

__construct (Constructor)   [line 101]

PHP_CodeSniffer_Standards_AbstractScopeSniff __construct( $scopeTokens, $tokens, [boolean $listenOutside = false])

Constructs a new AbstractScopeTest.
  • See: PHP_CodeSniffer.getValidScopeTokeners()
  • Throws: PHP_CodeSniffer_Test_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 161]

void process( PHP_CodeSniffer_File $phpcsFile, int $stackPtr)

Processes the tokens that this test is listening for.

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 228]

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 211]

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 140]

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 ]


Documentation generated on Mon, 17 Aug 2009 05:00:14 +0000 by phpDocumentor 1.4.2. PEAR Logo Copyright © PHP Group 2004.