> */ protected $targetFunctions = ['ini_get' => ['position' => 1, 'name' => 'option'], 'ini_set' => ['position' => 1, 'name' => 'option']]; /** * A list of deprecated/removed INI directives. * * The array lists : version number with false (deprecated) and true (removed). * If's sufficient to list the first version where the ini directive was deprecated/removed. * * @since 5.5 * @since 7.0.3 Support for 'alternative' has been added. * * @var array> */ protected $deprecatedIniDirectives = ['crack.default_dictionary' => ['5.0' => \true, 'extension' => 'crack'], 'dbx.colnames_case' => ['5.1' => \true, 'extension' => 'dbx'], 'fbsql.batchSize' => ['5.1' => \true, 'alternative' => 'fbsql.batchsize', 'extension' => 'fbsql'], 'pfpro.defaulthost' => ['5.1' => \true, 'extension' => 'pfpro'], 'pfpro.defaultport' => ['5.1' => \true, 'extension' => 'pfpro'], 'pfpro.defaulttimeout' => ['5.1' => \true, 'extension' => 'pfpro'], 'pfpro.proxyaddress' => ['5.1' => \true, 'extension' => 'pfpro'], 'pfpro.proxyport' => ['5.1' => \true, 'extension' => 'pfpro'], 'pfpro.proxylogon' => ['5.1' => \true, 'extension' => 'pfpro'], 'pfpro.proxypassword' => ['5.1' => \true, 'extension' => 'pfpro'], 'ingres.allow_persistent' => ['5.1' => \true, 'extension' => 'ingres'], 'ingres.default_database' => ['5.1' => \true, 'extension' => 'ingres'], 'ingres.default_password' => ['5.1' => \true, 'extension' => 'ingres'], 'ingres.default_user' => ['5.1' => \true, 'extension' => 'ingres'], 'ingres.max_links' => ['5.1' => \true, 'extension' => 'ingres'], 'ingres.max_persistent' => ['5.1' => \true, 'extension' => 'ingres'], 'hwapi.allow_persistent' => ['5.2' => \true, 'extension' => 'hwapi'], 'ifx.allow_persistent' => ['5.2.1' => \true, 'extension' => 'ifx'], 'ifx.blobinfile' => ['5.2.1' => \true, 'extension' => 'ifx'], 'ifx.byteasvarchar' => ['5.2.1' => \true, 'extension' => 'ifx'], 'ifx.charasvarchar' => ['5.2.1' => \true, 'extension' => 'ifx'], 'ifx.default_host' => ['5.2.1' => \true, 'extension' => 'ifx'], 'ifx.default_password' => ['5.2.1' => \true, 'extension' => 'ifx'], 'ifx.default_user' => ['5.2.1' => \true, 'extension' => 'ifx'], 'ifx.max_links' => ['5.2.1' => \true, 'extension' => 'ifx'], 'ifx.max_persistent' => ['5.2.1' => \true, 'extension' => 'ifx'], 'ifx.nullformat' => ['5.2.1' => \true, 'extension' => 'ifx'], 'ifx.textasvarchar' => ['5.2.1' => \true, 'extension' => 'ifx'], 'mime_magic.debug' => ['5.3' => \true, 'extension' => 'mimetype'], 'mime_magic.magicfile' => ['5.3' => \true, 'extension' => 'mimetype'], 'zend.ze1_compatibility_mode' => ['5.3' => \true], 'fbsql.allow_persistent' => ['5.3' => \true, 'extension' => 'fbsql'], 'fbsql.generate_warnings' => ['5.3' => \true, 'extension' => 'fbsql'], 'fbsql.autocommit' => ['5.3' => \true, 'extension' => 'fbsql'], 'fbsql.max_persistent' => ['5.3' => \true, 'extension' => 'fbsql'], 'fbsql.max_links' => ['5.3' => \true, 'extension' => 'fbsql'], 'fbsql.max_connections' => ['5.3' => \true, 'extension' => 'fbsql'], 'fbsql.max_results' => ['5.3' => \true, 'extension' => 'fbsql'], 'fbsql.default_host' => ['5.3' => \true, 'extension' => 'fbsql'], 'fbsql.default_user' => ['5.3' => \true, 'extension' => 'fbsql'], 'fbsql.default_password' => ['5.3' => \true, 'extension' => 'fbsql'], 'fbsql.default_database' => ['5.3' => \true, 'extension' => 'fbsql'], 'fbsql.default_database_password' => ['5.3' => \true, 'extension' => 'fbsql'], 'msql.allow_persistent' => ['5.3' => \true, 'extension' => 'msql'], 'msql.max_persistent' => ['5.3' => \true, 'extension' => 'msql'], 'msql.max_links' => ['5.3' => \true, 'extension' => 'msql'], 'allow_call_time_pass_reference' => ['5.3' => \false, '5.4' => \true], 'define_syslog_variables' => ['5.3' => \false, '5.4' => \true], 'detect_unicode' => ['5.4' => \true, 'alternative' => 'zend.detect_unicode'], 'highlight.bg' => ['5.3' => \false, '5.4' => \true], 'magic_quotes_gpc' => ['5.3' => \false, '5.4' => \true], 'magic_quotes_runtime' => ['5.3' => \false, '5.4' => \true], 'magic_quotes_sybase' => ['5.3' => \false, '5.4' => \true, 'extension' => 'sybase'], 'mbstring.script_encoding' => ['5.4' => \true, 'alternative' => 'zend.script_encoding', 'extension' => 'mbstring'], 'phar.extract_list' => ['5.4' => \true, 'extension' => 'phar'], 'register_globals' => ['5.3' => \false, '5.4' => \true], 'register_long_arrays' => ['5.3' => \false, '5.4' => \true], 'safe_mode' => ['5.3' => \false, '5.4' => \true], 'safe_mode_allowed_env_vars' => ['5.3' => \false, '5.4' => \true], 'safe_mode_exec_dir' => ['5.3' => \false, '5.4' => \true], 'safe_mode_gid' => ['5.3' => \false, '5.4' => \true], 'safe_mode_include_dir' => ['5.3' => \false, '5.4' => \true], 'safe_mode_protected_env_vars' => ['5.3' => \false, '5.4' => \true], 'session.bug_compat_42' => ['5.3' => \false, '5.4' => \true, 'extension' => 'session'], 'session.bug_compat_warn' => ['5.3' => \false, '5.4' => \true, 'extension' => 'session'], 'y2k_compliance' => ['5.3' => \false, '5.4' => \true], 'sqlite.assoc_case' => ['5.4' => \true, 'extension' => 'sqlite'], 'always_populate_raw_post_data' => ['5.6' => \false, '7.0' => \true], 'iconv.input_encoding' => ['5.6' => \false, 'extension' => 'iconv'], 'iconv.output_encoding' => ['5.6' => \false, 'extension' => 'iconv'], 'iconv.internal_encoding' => ['5.6' => \false, 'extension' => 'iconv'], 'mbstring.http_input' => ['5.6' => \false, 'extension' => 'mbstring'], 'mbstring.http_output' => ['5.6' => \false, 'extension' => 'mbstring'], 'mbstring.internal_encoding' => ['5.6' => \false, 'extension' => 'mbstring'], 'asp_tags' => ['7.0' => \true], 'xsl.security_prefs' => ['7.0' => \true], 'opcache.load_comments' => ['7.0' => \true, 'extension' => 'opcache'], 'mssql.allow_persistent' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.max_persistent' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.max_links' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.min_error_severity' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.min_message_severity' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.compatibility_mode' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.connect_timeout' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.timeout' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.textsize' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.textlimit' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.batchsize' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.datetimeconvert' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.secure_connection' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.max_procs' => ['7.0' => \true, 'extension' => 'mssql'], 'mssql.charset' => ['7.0' => \true, 'extension' => 'mssql'], 'mysql.allow_local_infile' => ['7.0' => \true, 'extension' => 'mysql'], 'mysql.allow_persistent' => ['7.0' => \true, 'extension' => 'mysql'], 'mysql.max_persistent' => ['7.0' => \true, 'extension' => 'mysql'], 'mysql.max_links' => ['7.0' => \true, 'extension' => 'mysql'], 'mysql.trace_mode' => ['7.0' => \true, 'extension' => 'mysql'], 'mysql.default_port' => ['7.0' => \true, 'extension' => 'mysql'], 'mysql.default_socket' => ['7.0' => \true, 'extension' => 'mysql'], 'mysql.default_host' => ['7.0' => \true, 'extension' => 'mysql'], 'mysql.default_user' => ['7.0' => \true, 'extension' => 'mysql'], 'mysql.default_password' => ['7.0' => \true, 'extension' => 'mysql'], 'mysql.connect_timeout' => ['7.0' => \true, 'extension' => 'mysql'], 'sybase.allow_persistent' => ['7.0' => \true, 'extension' => 'sybase'], 'sybase.max_persistent' => ['7.0' => \true, 'extension' => 'sybase'], 'sybase.max_links' => ['7.0' => \true, 'extension' => 'sybase'], 'sybase.interface_file' => ['7.0' => \true, 'extension' => 'sybase'], 'sybase.min_error_severity' => ['7.0' => \true, 'extension' => 'sybase'], 'sybase.min_message_severity' => ['7.0' => \true, 'extension' => 'sybase'], 'sybase.compatability_mode' => ['7.0' => \true, 'extension' => 'sybase'], 'mcrypt.algorithms_dir' => ['7.1' => \false, '7.2' => \true, 'extension' => 'mcrypt'], 'mcrypt.modes_dir' => ['7.1' => \false, '7.2' => \true, 'extension' => 'mcrypt'], 'session.entropy_file' => ['7.1' => \true, 'extension' => 'session'], 'session.entropy_length' => ['7.1' => \true, 'extension' => 'session'], 'session.hash_function' => ['7.1' => \true, 'extension' => 'session'], 'session.hash_bits_per_character' => ['7.1' => \true, 'extension' => 'session'], 'mbstring.func_overload' => ['7.2' => \false, '8.0' => \true, 'extension' => 'mbstring'], 'sql.safe_mode' => ['7.2' => \true], 'track_errors' => ['7.2' => \false, '8.0' => \true], 'opcache.fast_shutdown' => ['7.2' => \true, 'extension' => 'opcache'], 'birdstep.max_links' => ['7.3' => \true], 'opcache.inherited_hack' => [ '5.3' => \false, // Soft deprecated, i.e. ignored. '7.3' => \true, 'extension' => 'opcache', ], 'pdo_odbc.db2_instance_name' => [ '7.3' => \false, // Has been marked as deprecated in the manual from before this time. Now hard-deprecated. '8.0' => \true, 'extension' => 'pdo_odbc', ], 'allow_url_include' => ['7.4' => \false], 'ibase.allow_persistent' => ['7.4' => \true, 'extension' => 'ibase'], 'ibase.max_persistent' => ['7.4' => \true, 'extension' => 'ibase'], 'ibase.max_links' => ['7.4' => \true, 'extension' => 'ibase'], 'ibase.default_db' => ['7.4' => \true, 'extension' => 'ibase'], 'ibase.default_user' => ['7.4' => \true, 'extension' => 'ibase'], 'ibase.default_password' => ['7.4' => \true, 'extension' => 'ibase'], 'ibase.default_charset' => ['7.4' => \true, 'extension' => 'ibase'], 'ibase.timestampformat' => ['7.4' => \true, 'extension' => 'ibase'], 'ibase.dateformat' => ['7.4' => \true, 'extension' => 'ibase'], 'ibase.timeformat' => ['7.4' => \true, 'extension' => 'ibase'], 'assert.quiet_eval' => ['8.0' => \true], 'auto_detect_line_endings' => ['8.1' => \false], 'log_errors_max_len' => ['8.1' => \true], 'date.default_latitude' => ['8.1' => \false, 'extension' => 'datetime'], 'date.default_longitude' => ['8.1' => \false, 'extension' => 'datetime'], 'date.sunset_zenith' => ['8.1' => \false, 'extension' => 'datetime'], 'filter.default' => ['8.1' => \false, 'extension' => 'filter'], 'filter.default_options' => ['8.1' => \false, 'extension' => 'filter'], 'mysqlnd.fetch_data_copy' => ['8.1' => \true, 'extension' => 'mysqlnd'], 'oci8.old_oci_close_semantics' => ['8.1' => \false, '8.4' => \true, 'extension' => 'oci8'], 'mysqli.reconnect' => ['8.2' => \true, 'extension' => 'mysqli'], 'assert.active' => ['8.3' => \false, 'alternative' => 'zend.assertions'], 'assert.bail' => ['8.3' => \false, 'alternative' => 'zend.assertions'], 'assert.callback' => ['8.3' => \false, 'alternative' => 'zend.assertions'], 'assert.exception' => ['8.3' => \false, 'alternative' => 'zend.assertions'], 'assert.warning' => ['8.3' => \false, 'alternative' => 'zend.assertions'], 'opcache.consistency_checks' => ['8.3' => \true, 'extension' => 'opcache'], 'imap.enable_insecure_rsh' => ['8.4' => \true, 'extension' => 'imap'], 'oci8.connection_class' => ['8.4' => \true, 'extension' => 'oci8'], 'oci8.default_prefetch' => ['8.4' => \true, 'extension' => 'oci8'], 'oci8.events' => ['8.4' => \true, 'extension' => 'oci8'], 'oci8.max_persistent' => ['8.4' => \true, 'extension' => 'oci8'], 'oci8.persistent_timeout' => ['8.4' => \true, 'extension' => 'oci8'], 'oci8.ping_interval' => ['8.4' => \true, 'extension' => 'oci8'], 'oci8.prefetch_lob_size' => ['8.4' => \true, 'extension' => 'oci8'], 'oci8.privileged_connect' => ['8.4' => \true, 'extension' => 'oci8'], 'oci8.statement_cache_size' => ['8.4' => \true, 'extension' => 'oci8'], 'session.sid_length' => ['8.4' => \false, 'extension' => 'session'], 'session.sid_bits_per_character' => ['8.4' => \false, 'extension' => 'session'], 'disable_classes' => ['8.5' => \true], 'register_argc_argv' => ['8.5' => \false], 'report_memleaks' => ['8.5' => \false], 'intl.error_level' => ['8.5' => \false, 'extension' => 'intl', 'alternative' => 'intl.use_exceptions']]; /** * Should the sniff bow out early for specific PHP versions ? * * @since 10.0.0 * * @return bool */ protected function bowOutEarly() { return \false; } /** * Process the parameters of a matched function. * * @since 10.0.0 * * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned. * @param int $stackPtr The position of the current token in the stack. * @param string $functionName The token content (function name) which was matched. * @param array $parameters Array with information about the parameters. * * @return void */ public function processParameters(File $phpcsFile, $stackPtr, $functionName, $parameters) { $functionLc = \strtolower($functionName); $paramInfo = $this->targetFunctions[$functionLc]; $iniToken = PassedParameters::getParameterFromStack($parameters, $paramInfo['position'], $paramInfo['name']); if ($iniToken === \false) { return; } $filteredToken = TextStrings::stripQuotes($iniToken['clean']); if (isset($this->deprecatedIniDirectives[$filteredToken]) === \false) { return; } $itemInfo = ['name' => $filteredToken, 'functionLc' => $functionLc]; $this->handleFeature($phpcsFile, $iniToken['end'], $itemInfo); } /** * Handle the retrieval of relevant information and - if necessary - throwing of an * error/warning for a matched item. * * @since 10.0.0 * * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned. * @param int $stackPtr The position of the relevant token in * the stack. * @param array $itemInfo Base information about the item. * * @return void */ protected function handleFeature(File $phpcsFile, $stackPtr, array $itemInfo) { $itemArray = $this->deprecatedIniDirectives[$itemInfo['name']]; $versionInfo = $this->getVersionInfo($itemArray); $isError = null; if (empty($versionInfo['removed']) === \false && ScannedCode::shouldRunOnOrAbove($versionInfo['removed']) === \true) { $isError = \true; } elseif (empty($versionInfo['deprecated']) === \false && ScannedCode::shouldRunOnOrAbove($versionInfo['deprecated']) === \true) { $isError = \false; // Reset the 'removed' info as it is not relevant for the current notice. $versionInfo['removed'] = ''; } if (isset($isError) === \false) { return; } $this->addMessage($phpcsFile, $stackPtr, $isError, $itemInfo, $versionInfo); } /** * Generates the error or warning for this item. * * @since 10.0.0 * * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned. * @param int $stackPtr The position of the relevant token in * the stack. * @param bool $isError Whether this should be an error or a warning. * @param array $itemInfo Base information about the item. * @param string[] $versionInfo Array with detail (version) information * relevant to the item. * * @return void */ protected function addMessage(File $phpcsFile, $stackPtr, $isError, array $itemInfo, array $versionInfo) { // Overrule the default message template. $this->msgTemplate = "INI directive '%s' is "; $this->alternativeOptionTemplate = "; Use '%s' instead"; $msgInfo = $this->getMessageInfo($itemInfo['name'], $itemInfo['name'], $versionInfo); // Lower error level to warning if the function called was `ini_get()`. if ($itemInfo['functionLc'] === 'ini_get') { $isError = \false; } MessageHelper::addMessage($phpcsFile, $msgInfo['message'], $stackPtr, $isError, $msgInfo['errorcode'], $msgInfo['data']); } }