Documentation

EnqueuedResourceParametersSniff extends AbstractFunctionParameterSniff
in package

WPCS

WordPressCodingStandards

FinalYes

This checks the enqueued 4th and 5th parameters to make sure the version and in_footer are set.

If a source ($src) value is passed, then version ($ver) needs to have non-falsy value. If a source ($src) value is passed a check for in footer ($in_footer), warn the user if the value is falsy.

Properties

$exclude : array<string|int, mixed>: Exclude groups.
$unittest_groups : array<string|int, mixed>: Groups of function data to check against.
$excluded_groups : array<string|int, mixed>: Cache for the excluded groups information.
$group_name : string: The group name for this group of functions.
$groups : array<string|int, mixed>: Cache for the group information.
$phpcsFile : File: The current file being sniffed.
$regex_pattern : string: Regex pattern with placeholder for the function names.
$target_functions : array<string, true>: List of enqueued functions that need to be checked for use of the in_footer and version arguments.
$tokens : array<string|int, mixed>: The list of tokens in the current file being sniffed.
$false_tokens : array<int|string, int|string>: False + the empty tokens array.
$safe_tokens : array<int|string, int|string>: Token codes which are "safe" to accept to determine whether a version would evaluate to `false`.

Methods

check_for_matches() : int|void: Verify if the current token is one of the targetted functions.
getGroups() : array<string|int, mixed>: Groups of functions to restrict.
is_targetted_token() : bool: Verify is the current token is a function call.
process() : int|void: Set sniff properties and hand off to child class for processing of the token.
process_matched_token() : int|void: Process a matched token.
process_no_parameters() : int|void: Process the function if no parameters were found.
process_parameters() : void: Process the parameters of a matched function.
process_token() : int|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.
is_falsy() : bool: Determine if a range has a falsy value.
prepare_name_for_regex() : string: Prepare the function name for use in a regular expression.
setup_groups() : bool: Set up the regular expressions for each group.

$exclude

Exclude groups.


        public
            array<string|int, mixed>
    $exclude
     = array()

Example: 'switch_to_blog,user_meta'

$unittest_groups

Groups of function data to check against.


        public
        static    array<string|int, mixed>
    $unittest_groups
     = array()

Don't use this in extended classes, override getGroups() instead. This is only used for Unit tests.

$excluded_groups

Cache for the excluded groups information.


        protected
            array<string|int, mixed>
    $excluded_groups
     = array()

$group_name

The group name for this group of functions.


        protected
            string
    $group_name
     = 'Enqueued'

$groups

Cache for the group information.


        protected
            array<string|int, mixed>
    $groups
     = array()

$phpcsFile

The current file being sniffed.


        protected
            File
    $phpcsFile

$regex_pattern

Regex pattern with placeholder for the function names.


        protected
            string
    $regex_pattern
     = '`^(?:%s)$`i'

$target_functions

List of enqueued functions that need to be checked for use of the in_footer and version arguments.


        protected
            array<string, true>
    $target_functions
     = array('wp_register_script' => true, 'wp_enqueue_script' => true, 'wp_register_style' => true, 'wp_enqueue_style' => true)

Key is function name, value irrelevant.

$tokens

The list of tokens in the current file being sniffed.


        protected
            array<string|int, mixed>
    $tokens

$false_tokens

False + the empty tokens array.


        private
            array<int|string, int|string>
    $false_tokens
     = array(\T_FALSE => \T_FALSE)

This array is enriched with the $emptyTokens array in the register() method.

$safe_tokens

Token codes which are "safe" to accept to determine whether a version would evaluate to `false`.


        private
            array<int|string, int|string>
    $safe_tokens
     = array(\T_NULL => \T_NULL, \T_FALSE => \T_FALSE, \T_TRUE => \T_TRUE, \T_LNUMBER => \T_LNUMBER, \T_DNUMBER => \T_DNUMBER, \T_CONSTANT_ENCAPSED_STRING => \T_CONSTANT_ENCAPSED_STRING, \T_START_NOWDOC => \T_START_NOWDOC, \T_NOWDOC => \T_NOWDOC, \T_END_NOWDOC => \T_END_NOWDOC, \T_OPEN_PARENTHESIS => \T_OPEN_PARENTHESIS, \T_CLOSE_PARENTHESIS => \T_CLOSE_PARENTHESIS, \T_STRING_CONCAT => \T_STRING_CONCAT)

This array is enriched with the several of the PHPCS token arrays in the register() method.

check_for_matches()

Verify if the current token is one of the targetted functions.


    public
                    check_for_matches(int $stackPtr) : int|void

Parameters

$stackPtr : int: The position of the current token in the stack.

Return values

int|void —

Integer stack pointer to skip forward or void to continue normal file processing.

getGroups()

Groups of functions to restrict.


    public
                    getGroups() : array<string|int, mixed>

Return values

array<string|int, mixed>

is_targetted_token()

Verify is the current token is a function call.


    public
                    is_targetted_token(int $stackPtr) : bool

Parameters

$stackPtr : int: The position of the current token in the stack.

Return values

bool

process()

Set sniff properties and hand off to child class for processing of the token.


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

Parameters

$phpcsFile : File: The file being scanned.
$stackPtr : int: The position of the current token in the stack passed in $tokens.

Return values

int|void —

Integer stack pointer to skip forward or void to continue normal file processing.

process_matched_token()

Process a matched token.


    public
                    process_matched_token(int $stackPtr, string $group_name, string $matched_content) : int|void

Parameters

$stackPtr : int: The position of the current token in the stack.
$group_name : string: The name of the group which was matched.
$matched_content : string: The token content (function name) which was matched in lowercase.

Return values

int|void —

Integer stack pointer to skip forward or void to continue normal file processing.

process_no_parameters()

Process the function if no parameters were found.


    public
                    process_no_parameters(int $stackPtr, string $group_name, string $matched_content) : int|void

Defaults to doing nothing. Can be overloaded in child classes to handle functions were parameters are expected, but none found.

Parameters

$stackPtr : int: The position of the current token in the stack.
$group_name : string: The name of the group which was matched.
$matched_content : string: The token content (function name) which was matched in lowercase.

Return values

int|void —

Integer stack pointer to skip forward or void to continue normal file processing.

process_parameters()

Process the parameters of a matched function.


    public
                    process_parameters(int $stackPtr, string $group_name, string $matched_content, array<string|int, mixed> $parameters) : void

Parameters

$stackPtr : int: The position of the current token in the stack.
$group_name : string: The name of the group which was matched.
$matched_content : string: The token content (function name) which was matched in lowercase.
$parameters : array<string|int, mixed>: Array with information about the parameters.

process_token()

Processes this test, when one of its tokens is encountered.


    public
                    process_token(int $stackPtr) : int|void

Parameters

$stackPtr : int: The position of the current token in the stack.

Return values

int|void —

Integer stack pointer to skip forward or void to continue normal file processing.

register()

Returns an array of tokens this test wants to listen for.


    public
                    register() : array<string|int, mixed>

Overloads and calls the parent method to allow for adding additional tokens to the $safe_tokens property.

Return values

array<string|int, mixed>

is_falsy()

Determine if a range has a falsy value.


    protected
                    is_falsy(int $start, int $end) : bool

Parameters

$start : int: The position to start looking from.
$end : int: The position to stop looking (inclusive).

Return values

bool —

True if the parameter is falsy. False if the parameter is not falsy or when it couldn't be reliably determined.

prepare_name_for_regex()

Prepare the function name for use in a regular expression.


    protected
                    prepare_name_for_regex(string $function_name) : string

The getGroups() method allows for providing function names with a wildcard * to target a group of functions. This prepare routine takes that into account while still safely escaping the function name for use in a regular expression.

Parameters

$function_name : string: Function name.

Return values

string —

Regex escaped function name.

setup_groups()

Set up the regular expressions for each group.


    protected
                    setup_groups(string $key) : bool

Parameters

$key : string: The group array index key where the input for the regular expression can be found.

Return values

bool —

True if the groups were setup. False if not.

EnqueuedResourceParametersSniff extends AbstractFunctionParameterSniff in package WPCS WordPressCodingStandards

Tags

Table of Contents

Properties

Methods

Properties

$exclude

Tags

$unittest_groups

Tags

$excluded_groups

Tags

$group_name

Tags

$groups

Tags

$phpcsFile

Tags

$regex_pattern

Tags

$target_functions

Tags

$tokens

Tags

$false_tokens

$safe_tokens

Methods

check_for_matches()

Parameters

Tags

Return values

getGroups()

Return values

is_targetted_token()

Parameters

Tags

Return values

process()

Parameters

Tags

Return values

process_matched_token()

Parameters

Return values

process_no_parameters()

Parameters

Return values

process_parameters()

Parameters

Tags

process_token()

Parameters

Return values

register()

Return values

is_falsy()

Parameters

Return values

prepare_name_for_regex()

Parameters

Tags

Return values

setup_groups()

Parameters

Tags

Return values

EnqueuedResourceParametersSniff extends AbstractFunctionParameterSniff
in package

WPCS

WordPressCodingStandards