FunctionCommentSniff
extends FunctionCommentSniff
in package
Table of Contents
- $minimumVisibility : string
- Disable the check for functions with a lower visibility than the value given.
- $skipIfInheritdoc : bool
- Whether to skip inheritdoc comments.
- $specialMethods : array<string|int, mixed>
- Array of methods which do not require a return type.
- $phpVersion : int
- The current PHP version.
- 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.
- checkInheritdoc() : bool
- Determines whether the whole comment is an inheritdoc comment.
- checkSpacingAfterParamName() : void
- Check the spacing after the name of a parameter.
- checkSpacingAfterParamType() : void
- Check the spacing after the type of a parameter.
- 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.
$skipIfInheritdoc
Whether to skip inheritdoc comments.
public
bool
$skipIfInheritdoc
= false
$specialMethods
Array of methods which do not require a return type.
public
array<string|int, mixed>
$specialMethods
= ['__construct', '__destruct']
$phpVersion
The current PHP version.
private
int
$phpVersion
= null
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> —checkInheritdoc()
Determines whether the whole comment is an inheritdoc comment.
protected
checkInheritdoc(File $phpcsFile, int $stackPtr, int $commentStart) : bool
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
bool —TRUE if the docblock contains only (case-insensitive).
checkSpacingAfterParamName()
Check the spacing after the name of a parameter.
protected
checkSpacingAfterParamName(File $phpcsFile, array<string|int, mixed> $param, int $maxVar[, int $spacing = 1 ]) : void
Parameters
- $phpcsFile : File
-
The file being scanned.
- $param : array<string|int, mixed>
-
The parameter to be checked.
- $maxVar : int
-
The maxlength of the longest parameter name.
- $spacing : int = 1
-
The number of spaces to add after the type.
Return values
void —checkSpacingAfterParamType()
Check the spacing after the type of a parameter.
protected
checkSpacingAfterParamType(File $phpcsFile, array<string|int, mixed> $param, int $maxType[, int $spacing = 1 ]) : void
Parameters
- $phpcsFile : File
-
The file being scanned.
- $param : array<string|int, mixed>
-
The parameter to be checked.
- $maxType : int
-
The maxlength of the longest parameter type.
- $spacing : int = 1
-
The number of spaces to add after the type.
Return values
void —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.