sdc-build-wp 4.1.0 → 4.1.2

package/vendor/wp-coding-standards/wpcs/WordPress/Sniffs/PHP/NoSilencedErrorsSniff.php

@@ -1,245 +0,0 @@
-<?php
-/**
- * WordPress Coding Standard.
- *
- * @package WPCS\WordPressCodingStandards
- * @link    https://github.com/WordPress/WordPress-Coding-Standards
- * @license https://opensource.org/licenses/MIT MIT
- */
-
-namespace WordPressCS\WordPress\Sniffs\PHP;
-
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\BackCompat\BCFile;
-use PHPCSUtils\Utils\GetTokensAsString;
-use WordPressCS\WordPress\Helpers\RulesetPropertyHelper;
-use WordPressCS\WordPress\Sniff;
-
-/**
- * Discourage the use of the PHP error silencing operator.
- *
- * This sniff allows the error operator to be used with a select list
- * of functions, as no amount of error checking can prevent
- * PHP from throwing errors when those functions are used.
- *
- * @since 1.1.0
- */
-final class NoSilencedErrorsSniff extends Sniff {
-
-	/**
-	 * Number of tokens to display in the error message to show
-	 * the error silencing context.
-	 *
-	 * @since 1.1.0
-	 *
-	 * @var int
-	 */
-	public $context_length = 6;
-
-	/**
-	 * Whether or not the `$allowedFunctionsList` should be used.
-	 *
-	 * Defaults to true.
-	 *
-	 * This property only affects whether the standard function list is used.
-	 * The custom allowed functions list, if set, will always be respected.
-	 *
-	 * @since 1.1.0
-	 * @since 3.0.0 Renamed from `$use_default_whitelist` to `$usePHPFunctionsList`.
-	 *
-	 * @var bool
-	 */
-	public $usePHPFunctionsList = true;
-
-	/**
-	 * User defined function list.
-	 *
-	 * Allows users to pass a list of additional functions for which to allow
-	 * the use of the silence operator. This list can be set in a custom ruleset.
-	 *
-	 * @since 1.1.0
-	 * @since 3.0.0 Renamed from `$custom_whitelist` to `$customAllowedFunctionsList`.
-	 *
-	 * @var string[]
-	 */
-	public $customAllowedFunctionsList = array();
-
-	/**
-	 * PHP native functions allow list.
-	 *
-	 * Errors caused by calls to any of these native PHP functions
-	 * are allowed to be silenced as file system permissions and such
-	 * can cause E_WARNINGs to be thrown which cannot be prevented via
-	 * error checking.
-	 *
-	 * Note: only calls to global functions - in contrast to class methods -
-	 * are taken into account.
-	 *
-	 * Only functions for which the PHP manual annotates that an
-	 * error will be thrown on failure are accepted into this list.
-	 *
-	 * @since 1.1.0
-	 * @since 3.0.0 Renamed from `$function_whitelist` to `$allowedFunctionsList`.
-	 *
-	 * @var array<string, true> Key is function name, value irrelevant.
-	 */
-	protected $allowedFunctionsList = array(
-		// Directory extension.
-		'chdir'                        => true,
-		'opendir'                      => true,
-		'scandir'                      => true,
-
-		// File extension.
-		'file_exists'                  => true,
-		'file_get_contents'            => true,
-		'file'                         => true,
-		'fileatime'                    => true,
-		'filectime'                    => true,
-		'filegroup'                    => true,
-		'fileinode'                    => true,
-		'filemtime'                    => true,
-		'fileowner'                    => true,
-		'fileperms'                    => true,
-		'filesize'                     => true,
-		'filetype'                     => true,
-		'fopen'                        => true,
-		'is_dir'                       => true,
-		'is_executable'                => true,
-		'is_file'                      => true,
-		'is_link'                      => true,
-		'is_readable'                  => true,
-		'is_writable'                  => true,
-		'is_writeable'                 => true,
-		'lstat'                        => true,
-		'mkdir'                        => true,
-		'move_uploaded_file'           => true,
-		'readfile'                     => true,
-		'readlink'                     => true,
-		'rename'                       => true,
-		'rmdir'                        => true,
-		'stat'                         => true,
-		'unlink'                       => true,
-
-		// FTP extension.
-		'ftp_chdir'                    => true,
-		'ftp_login'                    => true,
-		'ftp_rename'                   => true,
-
-		// Stream extension.
-		'stream_select'                => true,
-		'stream_set_chunk_size'        => true,
-
-		// Zlib extension.
-		'deflate_add'                  => true,
-		'deflate_init'                 => true,
-		'inflate_add'                  => true,
-		'inflate_init'                 => true,
-		'readgzfile'                   => true,
-
-		// LibXML extension.
-		'libxml_disable_entity_loader' => true, // PHP 8.0 deprecation warning, but function call still needed in select cases.
-
-		// Miscellaneous other functions.
-		'imagecreatefromstring'        => true,
-		'imagecreatefromwebp'          => true,
-		'parse_url'                    => true, // Pre-PHP 5.3.3 an E_WARNING was thrown when URL parsing failed.
-		'unserialize'                  => true,
-	);
-
-	/**
-	 * Tokens which are regarded as empty for the purpose of determining
-	 * the name of the called function.
-	 *
-	 * This property is set from within the register() method.
-	 *
-	 * @since 1.1.0
-	 *
-	 * @var array<int|string, int|string>
-	 */
-	private $empty_tokens = array();
-
-	/**
-	 * Returns an array of tokens this test wants to listen for.
-	 *
-	 * @since 1.1.0
-	 *
-	 * @return array
-	 */
-	public function register() {
-		$this->empty_tokens                    = Tokens::$emptyTokens;
-		$this->empty_tokens[ \T_NS_SEPARATOR ] = \T_NS_SEPARATOR;
-		$this->empty_tokens[ \T_BITWISE_AND ]  = \T_BITWISE_AND;
-
-		return array(
-			\T_ASPERAND,
-		);
-	}
-
-	/**
-	 * Processes this test, when one of its tokens is encountered.
-	 *
-	 * @since 1.1.0
-	 *
-	 * @param int $stackPtr The position of the current token in the stack.
-	 */
-	public function process_token( $stackPtr ) {
-		// Handle the user-defined custom function list.
-		$this->customAllowedFunctionsList = RulesetPropertyHelper::merge_custom_array( $this->customAllowedFunctionsList, array(), false );
-		$this->customAllowedFunctionsList = array_map( 'strtolower', $this->customAllowedFunctionsList );
-
-		/*
-		 * Check if the error silencing is done for one of the allowed functions.
-		 *
-		 * @internal The function call name determination is done even when there is no allow list active
-		 * to allow the metrics to be more informative.
-		 */
-		$next_non_empty = $this->phpcsFile->findNext( $this->empty_tokens, ( $stackPtr + 1 ), null, true, null, true );
-		if ( false !== $next_non_empty && \T_STRING === $this->tokens[ $next_non_empty ]['code'] ) {
-			$has_parenthesis = $this->phpcsFile->findNext( Tokens::$emptyTokens, ( $next_non_empty + 1 ), null, true, null, true );
-			if ( false !== $has_parenthesis && \T_OPEN_PARENTHESIS === $this->tokens[ $has_parenthesis ]['code'] ) {
-				$function_name = strtolower( $this->tokens[ $next_non_empty ]['content'] );
-				if ( ( true === $this->usePHPFunctionsList
-					&& isset( $this->allowedFunctionsList[ $function_name ] ) === true )
-					|| ( ! empty( $this->customAllowedFunctionsList )
-					&& in_array( $function_name, $this->customAllowedFunctionsList, true ) === true )
-				) {
-					$this->phpcsFile->recordMetric( $stackPtr, 'Error silencing', 'silencing allowed function call: ' . $function_name );
-					return;
-				}
-			}
-		}
-
-		$this->context_length = (int) $this->context_length;
-		$context_length       = $this->context_length;
-		if ( $this->context_length <= 0 ) {
-			$context_length = 2;
-		}
-
-		// Prepare the "Found" string to display.
-		$end_of_statement = BCFile::findEndOfStatement( $this->phpcsFile, $stackPtr, \T_COMMA );
-		if ( ( $end_of_statement - $stackPtr ) < $context_length ) {
-			$context_length = ( $end_of_statement - $stackPtr );
-		}
-
-		$found     = GetTokensAsString::compact( $this->phpcsFile, $stackPtr, ( $stackPtr + $context_length - 1 ), true ) . '...';
-		$error_msg = 'Silencing errors is strongly discouraged. Use proper error checking instead.';
-		$data      = array();
-		if ( $this->context_length > 0 ) {
-			$error_msg .= ' Found: %s';
-			$data[]     = $found;
-		}
-
-		$this->phpcsFile->addWarning(
-			$error_msg,
-			$stackPtr,
-			'Discouraged',
-			$data
-		);
-
-		if ( isset( $function_name ) ) {
-			$this->phpcsFile->recordMetric( $stackPtr, 'Error silencing', '@' . $function_name );
-		} else {
-			$this->phpcsFile->recordMetric( $stackPtr, 'Error silencing', $found );
-		}
-	}
-}

package/vendor/wp-coding-standards/wpcs/WordPress/Sniffs/PHP/POSIXFunctionsSniff.php

@@ -1,73 +0,0 @@
-<?php
-/**
- * WordPress Coding Standard.
- *
- * @package WPCS\WordPressCodingStandards
- * @link    https://github.com/WordPress/WordPress-Coding-Standards
- * @license https://opensource.org/licenses/MIT MIT
- */
-
-namespace WordPressCS\WordPress\Sniffs\PHP;
-
-use WordPressCS\WordPress\AbstractFunctionRestrictionsSniff;
-
-/**
- * Perl compatible regular expressions (PCRE, preg_ functions) should be used in preference
- * to their POSIX counterparts.
- *
- * @link https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/#regular-expressions
- * @link https://php-legacy-docs.zend.com/manual/php5/en/ref.regex
- *
- * @since 0.10.0 Previously this check was contained within the
- *               `WordPress.VIP.RestrictedFunctions` and the
- *               `WordPress.PHP.DiscouragedPHPFunctions` sniffs.
- * @since 0.13.0 Class name changed: this class is now namespaced.
- */
-final class POSIXFunctionsSniff extends AbstractFunctionRestrictionsSniff {
-
-	/**
-	 * Groups of functions to restrict.
-	 *
-	 * Example: groups => array(
-	 *  'lambda' => array(
-	 *      'type'      => 'error' | 'warning',
-	 *      'message'   => 'Use anonymous functions instead please!',
-	 *      'functions' => array( 'file_get_contents', 'create_function' ),
-	 *  )
-	 * )
-	 *
-	 * @return array
-	 */
-	public function getGroups() {
-		return array(
-			'ereg' => array(
-				'type'      => 'error',
-				'message'   => '%s() has been deprecated since PHP 5.3 and removed in PHP 7.0, please use preg_match() instead.',
-				'functions' => array(
-					'ereg',
-					'eregi',
-					'sql_regcase',
-				),
-			),
-
-			'ereg_replace' => array(
-				'type'      => 'error',
-				'message'   => '%s() has been deprecated since PHP 5.3 and removed in PHP 7.0, please use preg_replace() instead.',
-				'functions' => array(
-					'ereg_replace',
-					'eregi_replace',
-				),
-			),
-
-			'split' => array(
-				'type'      => 'error',
-				'message'   => '%s() has been deprecated since PHP 5.3 and removed in PHP 7.0, please use explode(), str_split() or preg_split() instead.',
-				'functions' => array(
-					'split',
-					'spliti',
-				),
-			),
-
-		);
-	}
-}

package/vendor/wp-coding-standards/wpcs/WordPress/Sniffs/PHP/PregQuoteDelimiterSniff.php

@@ -1,70 +0,0 @@
-<?php
-/**
- * WordPress Coding Standard.
- *
- * @package WPCS\WordPressCodingStandards
- * @link    https://github.com/WordPress/WordPress-Coding-Standards
- * @license https://opensource.org/licenses/MIT MIT
- */
-
-namespace WordPressCS\WordPress\Sniffs\PHP;
-
-use PHPCSUtils\Utils\PassedParameters;
-use WordPressCS\WordPress\AbstractFunctionParameterSniff;
-
-/**
- * Flag calling preg_quote() without the second ($delimiter) parameter.
- *
- * @since 1.0.0
- */
-final class PregQuoteDelimiterSniff extends AbstractFunctionParameterSniff {
-
-	/**
-	 * The group name for this group of functions.
-	 *
-	 * @since 1.0.0
-	 *
-	 * @var string
-	 */
-	protected $group_name = 'preg_quote';
-
-	/**
-	 * List of functions this sniff should examine.
-	 *
-	 * @link https://www.php.net/preg_quote
-	 *
-	 * @since 1.0.0
-	 *
-	 * @var array<string, true> Key is function name, value irrelevant.
-	 */
-	protected $target_functions = array(
-		'preg_quote' => true,
-	);
-
-	/**
-	 * Process the parameters of a matched function.
-	 *
-	 * @since 1.0.0
-	 *
-	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param string $group_name      The name of the group which was matched.
-	 * @param string $matched_content The token content (function name) which was matched
-	 *                                in lowercase.
-	 * @param array  $parameters      Array with information about the parameters.
-	 *
-	 * @return void
-	 */
-	public function process_parameters( $stackPtr, $group_name, $matched_content, $parameters ) {
-
-		$delimiter = PassedParameters::getParameterFromStack( $parameters, 2, 'delimiter' );
-		if ( false !== $delimiter ) {
-			return;
-		}
-
-		$this->phpcsFile->addWarning(
-			'Passing the $delimiter parameter to preg_quote() is strongly recommended.',
-			$stackPtr,
-			'Missing'
-		);
-	}
-}

package/vendor/wp-coding-standards/wpcs/WordPress/Sniffs/PHP/RestrictedPHPFunctionsSniff.php

@@ -1,45 +0,0 @@
-<?php
-/**
- * WordPress Coding Standard.
- *
- * @package WPCS\WordPressCodingStandards
- * @link    https://github.com/WordPress/WordPress-Coding-Standards
- * @license https://opensource.org/licenses/MIT MIT
- */
-
-namespace WordPressCS\WordPress\Sniffs\PHP;
-
-use WordPressCS\WordPress\AbstractFunctionRestrictionsSniff;
-
-/**
- * Forbids the use of various native PHP functions and suggests alternatives.
- *
- * @since 0.14.0
- */
-final class RestrictedPHPFunctionsSniff extends AbstractFunctionRestrictionsSniff {
-
-	/**
-	 * Groups of functions to forbid.
-	 *
-	 * Example: groups => array(
-	 *  'lambda' => array(
-	 *      'type'      => 'error' | 'warning',
-	 *      'message'   => 'Use anonymous functions instead please!',
-	 *      'functions' => array( 'file_get_contents', 'create_function' ),
-	 *  )
-	 * )
-	 *
-	 * @return array
-	 */
-	public function getGroups() {
-		return array(
-			'create_function' => array(
-				'type'      => 'error',
-				'message'   => '%s() is deprecated as of PHP 7.2 and removed in PHP 8.0. Please use declared named or anonymous functions instead.',
-				'functions' => array(
-					'create_function',
-				),
-			),
-		);
-	}
-}

package/vendor/wp-coding-standards/wpcs/WordPress/Sniffs/PHP/StrictInArraySniff.php

@@ -1,122 +0,0 @@
-<?php
-/**
- * WordPress Coding Standard.
- *
- * @package WPCS\WordPressCodingStandards
- * @link    https://github.com/WordPress/WordPress-Coding-Standards
- * @license https://opensource.org/licenses/MIT MIT
- */
-
-namespace WordPressCS\WordPress\Sniffs\PHP;
-
-use PHPCSUtils\Utils\PassedParameters;
-use WordPressCS\WordPress\AbstractFunctionParameterSniff;
-
-/**
- * Flag calling in_array(), array_search() and array_keys() without true as the third parameter.
- *
- * @since 0.9.0
- * @since 0.10.0 - This sniff not only checks for `in_array()`, but also `array_search()`
- *                 and `array_keys()`.
- *               - The sniff no longer needlessly extends the `ArrayAssignmentRestrictionsSniff`
- *                 class which it didn't use.
- * @since 0.11.0 Refactored to extend the new WordPressCS native `AbstractFunctionParameterSniff` class.
- * @since 0.13.0 Class name changed: this class is now namespaced.
- */
-final class StrictInArraySniff extends AbstractFunctionParameterSniff {
-
-	/**
-	 * The group name for this group of functions.
-	 *
-	 * @since 0.11.0
-	 *
-	 * @var string
-	 */
-	protected $group_name = 'strict';
-
-	/**
-	 * List of array functions to which a $strict parameter can be passed.
-	 *
-	 * The array_keys() function only requires the $strict parameter when the optional
-	 * second parameter $filter_value has been set.
-	 *
-	 * @link https://www.php.net/in-array
-	 * @link https://www.php.net/array-search
-	 * @link https://www.php.net/array-keys
-	 *
-	 * @since 0.10.0
-	 * @since 0.11.0 Renamed from $array_functions to $target_functions.
-	 * @since 3.0.0  The format of the array value has changed from boolean to array.
-	 *
-	 * @var array<string, array{param_position: int, param_name: string, always_needed: bool}> Key is the function name.
-	 */
-	protected $target_functions = array(
-		'in_array'     => array(
-			'param_position' => 3,
-			'param_name'     => 'strict',
-			'always_needed'  => true,
-		),
-		'array_search' => array(
-			'param_position' => 3,
-			'param_name'     => 'strict',
-			'always_needed'  => true,
-		),
-		'array_keys'   => array(
-			'param_position' => 3,
-			'param_name'     => 'strict',
-			'always_needed'  => false,
-		),
-	);
-
-	/**
-	 * Process the parameters of a matched function.
-	 *
-	 * @since 0.11.0
-	 *
-	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param string $group_name      The name of the group which was matched.
-	 * @param string $matched_content The token content (function name) which was matched
-	 *                                in lowercase.
-	 * @param array  $parameters      Array with information about the parameters.
-	 *
-	 * @return void
-	 */
-	public function process_parameters( $stackPtr, $group_name, $matched_content, $parameters ) {
-		$param_info = $this->target_functions[ $matched_content ];
-
-		/*
-		 * Check if the strict check is actually needed.
-		 *
-		 * Important! This check only applies to array_keys() in the current form of the sniff
-		 * and has been written to be specific to that function.
-		 * If more functions would be added with 'always_needed' set to `false`,
-		 * this code will need to be adjusted to handle those.
-		 */
-		if ( false === $param_info['always_needed'] ) {
-			$has_filter_value = PassedParameters::getParameterFromStack( $parameters, 2, 'filter_value' );
-			if ( false === $has_filter_value ) {
-				return;
-			}
-		}
-
-		$found_parameter = PassedParameters::getParameterFromStack( $parameters, $param_info['param_position'], $param_info['param_name'] );
-		if ( false === $found_parameter || 'true' !== strtolower( $found_parameter['clean'] ) ) {
-			$errorcode = 'MissingTrueStrict';
-
-			/*
-			 * Use a different error code when `false` is found to allow for excluding
-			 * the warning as this will be a conscious choice made by the dev.
-			 */
-			if ( is_array( $found_parameter ) && 'false' === strtolower( $found_parameter['clean'] ) ) {
-				$errorcode = 'FoundNonStrictFalse';
-			}
-
-			$this->phpcsFile->addWarning(
-				'Not using strict comparison for %s; supply true for $%s argument.',
-				( isset( $found_parameter['start'] ) ? $found_parameter['start'] : $stackPtr ),
-				$errorcode,
-				array( $matched_content, $param_info['param_name'] )
-			);
-		}
-	}
-}

package/vendor/wp-coding-standards/wpcs/WordPress/Sniffs/PHP/TypeCastsSniff.php

@@ -1,90 +0,0 @@
-<?php
-/**
- * WordPress Coding Standard.
- *
- * @package WPCS\WordPressCodingStandards
- * @link    https://github.com/WordPress/WordPress-Coding-Standards
- * @license https://opensource.org/licenses/MIT MIT
- */
-
-namespace WordPressCS\WordPress\Sniffs\PHP;
-
-use WordPressCS\WordPress\Sniff;
-
-/**
- * Verifies the correct usage of type cast keywords.
- *
- * Type casts should be:
- * - normalized, i.e. (float) not (real).
- *
- * Additionally, the use of the (unset) and (binary) casts is discouraged.
- *
- * @link https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/#space-usage
- *
- * @since 1.2.0
- * @since 2.0.0 No longer checks that type casts are lowercase or short form.
- *              Relevant PHPCS native sniffs have been included in the rulesets instead.
- */
-final class TypeCastsSniff extends Sniff {
-
-	/**
-	 * Returns an array of tokens this test wants to listen for.
-	 *
-	 * @return array
-	 */
-	public function register() {
-		return array(
-			\T_DOUBLE_CAST,
-			\T_UNSET_CAST,
-			\T_BINARY_CAST,
-		);
-	}
-
-	/**
-	 * Processes this test, when one of its tokens is encountered.
-	 *
-	 * @param int $stackPtr The position of the current token in the stack.
-	 *
-	 * @return void
-	 */
-	public function process_token( $stackPtr ) {
-
-		$token_code  = $this->tokens[ $stackPtr ]['code'];
-		$typecast    = str_replace( ' ', '', $this->tokens[ $stackPtr ]['content'] );
-		$typecast_lc = strtolower( $typecast );
-
-		switch ( $token_code ) {
-			case \T_DOUBLE_CAST:
-				if ( '(float)' !== $typecast_lc ) {
-					$fix = $this->phpcsFile->addFixableError(
-						'Normalized type keywords must be used; expected "(float)" but found "%s"',
-						$stackPtr,
-						'DoubleRealFound',
-						array( $typecast )
-					);
-
-					if ( true === $fix ) {
-						$this->phpcsFile->fixer->replaceToken( $stackPtr, '(float)' );
-					}
-				}
-				break;
-
-			case \T_UNSET_CAST:
-				$this->phpcsFile->addError(
-					'Using the "(unset)" cast is forbidden as the type cast is removed in PHP 8.0. Use the "unset()" language construct instead.',
-					$stackPtr,
-					'UnsetFound'
-				);
-				break;
-
-			case \T_BINARY_CAST:
-				$this->phpcsFile->addWarning(
-					'Using binary casting is strongly discouraged. Found: "%s"',
-					$stackPtr,
-					'BinaryFound',
-					array( $typecast )
-				);
-				break;
-		}
-	}
-}