FunctionCommentSniff
in package
implements
Sniff
Interfaces, Classes and Traits
Table of Contents
- $minimumVisibility : string
- Disable the check for functions with a lower visibility than the value given.
- $specialMethods : array<string|int, mixed>
- Array of methods which do not require a return type.
- process() : void
- Processes this test, when one of its tokens is encountered.
- register() : array<string|int, mixed>
- Returns an array of tokens this test wants to listen for.
- processParams() : void
- Process the function parameter comments.
- processReturn() : void
- Process the return comment of this function comment.
- processThrows() : void
- Process any throw tags that this function comment has.
Properties
$minimumVisibility
Disable the check for functions with a lower visibility than the value given.
public
string
$minimumVisibility
= 'private'
Allowed values are public, protected, and private.
$specialMethods
Array of methods which do not require a return type.
public
array<string|int, mixed>
$specialMethods
= ['__construct', '__destruct']
Methods
process()
Processes this test, when one of its tokens is encountered.
public
process(File $phpcsFile, int $stackPtr) : void
Parameters
- $phpcsFile : File
-
The file being scanned.
- $stackPtr : int
-
The position of the current token in the stack passed in $tokens.
Return values
void —register()
Returns an array of tokens this test wants to listen for.
public
register() : array<string|int, mixed>
Return values
array<string|int, mixed> —processParams()
Process the function parameter comments.
protected
processParams(File $phpcsFile, int $stackPtr, int $commentStart) : void
Parameters
- $phpcsFile : File
-
The file being scanned.
- $stackPtr : int
-
The position of the current token in the stack passed in $tokens.
- $commentStart : int
-
The position in the stack where the comment started.
Return values
void —processReturn()
Process the return comment of this function comment.
protected
processReturn(File $phpcsFile, int $stackPtr, int $commentStart) : void
Parameters
- $phpcsFile : File
-
The file being scanned.
- $stackPtr : int
-
The position of the current token in the stack passed in $tokens.
- $commentStart : int
-
The position in the stack where the comment started.
Return values
void —processThrows()
Process any throw tags that this function comment has.
protected
processThrows(File $phpcsFile, int $stackPtr, int $commentStart) : void
Parameters
- $phpcsFile : File
-
The file being scanned.
- $stackPtr : int
-
The position of the current token in the stack passed in $tokens.
- $commentStart : int
-
The position in the stack where the comment started.