mirror of
https://github.com/WordPress/WordPress.git
synced 2024-09-07 13:18:14 +02:00
This is an important release which makes significant changes to improve the accuracy, performance, stability and maintainability of all sniffs, as well as making WordPressCS much better at handling modern PHP. WordPressCS 3.0.0 contains breaking changes, both for people using ignore annotations, people maintaining custom rulesets, as well as for sniff developers who maintain a custom PHPCS standard based on WordPressCS. If you are an end-user or maintain a custom WordPressCS based ruleset, please start by reading the [https://github.com/WordPress/WordPress-Coding-Standards/wiki/Upgrade-Guide-to-WordPressCS-3.0.0-for-ruleset-maintainers Upgrade Guide to WordPressCS 3.0.0 for ruleset maintainers] which lists the most important changes and contains a step by step guide for upgrading. If you are a maintainer of an external standard based on WordPressCS and any of your custom sniffs are based on or extend WordPressCS sniffs, please read the [https://github.com/WordPress/WordPress-Coding-Standards/wiki/Upgrade-Guide-to-WordPressCS-3.0.0-for-Developers-of-external-standards Upgrade Guide to WordPressCS 3.0.0 for Developers]. In all cases, please read the complete changelog carefully before you upgrade. This commit: * Updates the Composer dependencies to use the new version, including updating the underlying PHP_CodeSniffer dependency to the new minimum supported version for WPCS.[[BR]] Note: the Composer PHPCS installer plugin is no longer explicitly required as it is now a dependency of WPCS, so the dependency is inherited automatically. * Updates the ruleset for WPCS 3.0.0. This includes: * Raising the memory limit to be on the safe side as WPCS 3.0.0 contains a lot more sniffs. * Removing explicit inclusions of extra rules, which have now been added to the `WordPress-Core` ruleset.. * Updating property names for select sniffs. * Updating one exclusion — the `WordPress.CodeAnalysis.AssignmentInCondition` sniff has been (partially) replaced by the `Generic.CodeAnalysis.AssignmentInCondition` sniff. * Adding one new exclusion. * Downgrades one new error to a warning.[[BR]] The `Generic.Files.OneObjectStructurePerFile` sniff enforces that there is only one OO structure declaration per file. At this time, this sniff would yield 29 errors. By downgrading the sniff to a ''warning'', the build can pass and the issues can be fixed in due time. For now, the test directory will be excluded until the issues are fixed (as the test directory CS run does not allow for warnings). * Updates ignore annotations for WPCS 3.0.0. Reference: [https://github.com/WordPress/WordPress-Coding-Standards/releases/tag/3.0.0 WPCS 3.0.0 release notes]. Follow-up to [43571], [44574], [45600], [47927]. Props jrf, jorbin, desrosj. See #59161. Built from https://develop.svn.wordpress.org/trunk@56695 git-svn-id: http://core.svn.wordpress.org/trunk@56207 1a063a9b-81f0-0310-95a4-ce76da25c4cd
459 lines
13 KiB
PHP
459 lines
13 KiB
PHP
<?php
|
|
/**
|
|
* Class for testing automatic updates in the WordPress code.
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Site_Health
|
|
* @since 5.2.0
|
|
*/
|
|
|
|
#[AllowDynamicProperties]
|
|
class WP_Site_Health_Auto_Updates {
|
|
/**
|
|
* WP_Site_Health_Auto_Updates constructor.
|
|
*
|
|
* @since 5.2.0
|
|
*/
|
|
public function __construct() {
|
|
require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
|
|
}
|
|
|
|
|
|
/**
|
|
* Runs tests to determine if auto-updates can run.
|
|
*
|
|
* @since 5.2.0
|
|
*
|
|
* @return array The test results.
|
|
*/
|
|
public function run_tests() {
|
|
$tests = array(
|
|
$this->test_constants( 'WP_AUTO_UPDATE_CORE', array( true, 'beta', 'rc', 'development', 'branch-development', 'minor' ) ),
|
|
$this->test_wp_version_check_attached(),
|
|
$this->test_filters_automatic_updater_disabled(),
|
|
$this->test_wp_automatic_updates_disabled(),
|
|
$this->test_if_failed_update(),
|
|
$this->test_vcs_abspath(),
|
|
$this->test_check_wp_filesystem_method(),
|
|
$this->test_all_files_writable(),
|
|
$this->test_accepts_dev_updates(),
|
|
$this->test_accepts_minor_updates(),
|
|
);
|
|
|
|
$tests = array_filter( $tests );
|
|
$tests = array_map(
|
|
static function ( $test ) {
|
|
$test = (object) $test;
|
|
|
|
if ( empty( $test->severity ) ) {
|
|
$test->severity = 'warning';
|
|
}
|
|
|
|
return $test;
|
|
},
|
|
$tests
|
|
);
|
|
|
|
return $tests;
|
|
}
|
|
|
|
/**
|
|
* Tests if auto-updates related constants are set correctly.
|
|
*
|
|
* @since 5.2.0
|
|
* @since 5.5.1 The `$value` parameter can accept an array.
|
|
*
|
|
* @param string $constant The name of the constant to check.
|
|
* @param bool|string|array $value The value that the constant should be, if set,
|
|
* or an array of acceptable values.
|
|
* @return array The test results.
|
|
*/
|
|
public function test_constants( $constant, $value ) {
|
|
$acceptable_values = (array) $value;
|
|
|
|
if ( defined( $constant ) && ! in_array( constant( $constant ), $acceptable_values, true ) ) {
|
|
return array(
|
|
'description' => sprintf(
|
|
/* translators: 1: Name of the constant used. 2: Value of the constant used. */
|
|
__( 'The %1$s constant is defined as %2$s' ),
|
|
"<code>$constant</code>",
|
|
'<code>' . esc_html( var_export( constant( $constant ), true ) ) . '</code>'
|
|
),
|
|
'severity' => 'fail',
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks if updates are intercepted by a filter.
|
|
*
|
|
* @since 5.2.0
|
|
*
|
|
* @return array The test results.
|
|
*/
|
|
public function test_wp_version_check_attached() {
|
|
if ( ( ! is_multisite() || is_main_site() && is_network_admin() )
|
|
&& ! has_filter( 'wp_version_check', 'wp_version_check' )
|
|
) {
|
|
return array(
|
|
'description' => sprintf(
|
|
/* translators: %s: Name of the filter used. */
|
|
__( 'A plugin has prevented updates by disabling %s.' ),
|
|
'<code>wp_version_check()</code>'
|
|
),
|
|
'severity' => 'fail',
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks if automatic updates are disabled by a filter.
|
|
*
|
|
* @since 5.2.0
|
|
*
|
|
* @return array The test results.
|
|
*/
|
|
public function test_filters_automatic_updater_disabled() {
|
|
/** This filter is documented in wp-admin/includes/class-wp-automatic-updater.php */
|
|
if ( apply_filters( 'automatic_updater_disabled', false ) ) {
|
|
return array(
|
|
'description' => sprintf(
|
|
/* translators: %s: Name of the filter used. */
|
|
__( 'The %s filter is enabled.' ),
|
|
'<code>automatic_updater_disabled</code>'
|
|
),
|
|
'severity' => 'fail',
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks if automatic updates are disabled.
|
|
*
|
|
* @since 5.3.0
|
|
*
|
|
* @return array|false The test results. False if auto-updates are enabled.
|
|
*/
|
|
public function test_wp_automatic_updates_disabled() {
|
|
if ( ! class_exists( 'WP_Automatic_Updater' ) ) {
|
|
require_once ABSPATH . 'wp-admin/includes/class-wp-automatic-updater.php';
|
|
}
|
|
|
|
$auto_updates = new WP_Automatic_Updater();
|
|
|
|
if ( ! $auto_updates->is_disabled() ) {
|
|
return false;
|
|
}
|
|
|
|
return array(
|
|
'description' => __( 'All automatic updates are disabled.' ),
|
|
'severity' => 'fail',
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Checks if automatic updates have tried to run, but failed, previously.
|
|
*
|
|
* @since 5.2.0
|
|
*
|
|
* @return array|false The test results. False if the auto-updates failed.
|
|
*/
|
|
public function test_if_failed_update() {
|
|
$failed = get_site_option( 'auto_core_update_failed' );
|
|
|
|
if ( ! $failed ) {
|
|
return false;
|
|
}
|
|
|
|
if ( ! empty( $failed['critical'] ) ) {
|
|
$description = __( 'A previous automatic background update ended with a critical failure, so updates are now disabled.' );
|
|
$description .= ' ' . __( 'You would have received an email because of this.' );
|
|
$description .= ' ' . __( "When you've been able to update using the \"Update now\" button on Dashboard > Updates, this error will be cleared for future update attempts." );
|
|
$description .= ' ' . sprintf(
|
|
/* translators: %s: Code of error shown. */
|
|
__( 'The error code was %s.' ),
|
|
'<code>' . $failed['error_code'] . '</code>'
|
|
);
|
|
return array(
|
|
'description' => $description,
|
|
'severity' => 'warning',
|
|
);
|
|
}
|
|
|
|
$description = __( 'A previous automatic background update could not occur.' );
|
|
if ( empty( $failed['retry'] ) ) {
|
|
$description .= ' ' . __( 'You would have received an email because of this.' );
|
|
}
|
|
|
|
$description .= ' ' . __( 'Another attempt will be made with the next release.' );
|
|
$description .= ' ' . sprintf(
|
|
/* translators: %s: Code of error shown. */
|
|
__( 'The error code was %s.' ),
|
|
'<code>' . $failed['error_code'] . '</code>'
|
|
);
|
|
return array(
|
|
'description' => $description,
|
|
'severity' => 'warning',
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Checks if WordPress is controlled by a VCS (Git, Subversion etc).
|
|
*
|
|
* @since 5.2.0
|
|
*
|
|
* @return array The test results.
|
|
*/
|
|
public function test_vcs_abspath() {
|
|
$context_dirs = array( ABSPATH );
|
|
$vcs_dirs = array( '.svn', '.git', '.hg', '.bzr' );
|
|
$check_dirs = array();
|
|
|
|
foreach ( $context_dirs as $context_dir ) {
|
|
// Walk up from $context_dir to the root.
|
|
do {
|
|
$check_dirs[] = $context_dir;
|
|
|
|
// Once we've hit '/' or 'C:\', we need to stop. dirname will keep returning the input here.
|
|
if ( dirname( $context_dir ) === $context_dir ) {
|
|
break;
|
|
}
|
|
|
|
// Continue one level at a time.
|
|
} while ( $context_dir = dirname( $context_dir ) );
|
|
}
|
|
|
|
$check_dirs = array_unique( $check_dirs );
|
|
|
|
// Search all directories we've found for evidence of version control.
|
|
foreach ( $vcs_dirs as $vcs_dir ) {
|
|
foreach ( $check_dirs as $check_dir ) {
|
|
// phpcs:ignore Generic.CodeAnalysis.AssignmentInCondition,Squiz.PHP.DisallowMultipleAssignments
|
|
if ( $checkout = @is_dir( rtrim( $check_dir, '\\/' ) . "/$vcs_dir" ) ) {
|
|
break 2;
|
|
}
|
|
}
|
|
}
|
|
|
|
/** This filter is documented in wp-admin/includes/class-wp-automatic-updater.php */
|
|
if ( $checkout && ! apply_filters( 'automatic_updates_is_vcs_checkout', true, ABSPATH ) ) {
|
|
return array(
|
|
'description' => sprintf(
|
|
/* translators: 1: Folder name. 2: Version control directory. 3: Filter name. */
|
|
__( 'The folder %1$s was detected as being under version control (%2$s), but the %3$s filter is allowing updates.' ),
|
|
'<code>' . $check_dir . '</code>',
|
|
"<code>$vcs_dir</code>",
|
|
'<code>automatic_updates_is_vcs_checkout</code>'
|
|
),
|
|
'severity' => 'info',
|
|
);
|
|
}
|
|
|
|
if ( $checkout ) {
|
|
return array(
|
|
'description' => sprintf(
|
|
/* translators: 1: Folder name. 2: Version control directory. */
|
|
__( 'The folder %1$s was detected as being under version control (%2$s).' ),
|
|
'<code>' . $check_dir . '</code>',
|
|
"<code>$vcs_dir</code>"
|
|
),
|
|
'severity' => 'warning',
|
|
);
|
|
}
|
|
|
|
return array(
|
|
'description' => __( 'No version control systems were detected.' ),
|
|
'severity' => 'pass',
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Checks if we can access files without providing credentials.
|
|
*
|
|
* @since 5.2.0
|
|
*
|
|
* @return array The test results.
|
|
*/
|
|
public function test_check_wp_filesystem_method() {
|
|
// Make sure the `request_filesystem_credentials()` function is available during our REST API call.
|
|
if ( ! function_exists( 'request_filesystem_credentials' ) ) {
|
|
require_once ABSPATH . 'wp-admin/includes/file.php';
|
|
}
|
|
|
|
$skin = new Automatic_Upgrader_Skin();
|
|
$success = $skin->request_filesystem_credentials( false, ABSPATH );
|
|
|
|
if ( ! $success ) {
|
|
$description = __( 'Your installation of WordPress prompts for FTP credentials to perform updates.' );
|
|
$description .= ' ' . __( '(Your site is performing updates over FTP due to file ownership. Talk to your hosting company.)' );
|
|
|
|
return array(
|
|
'description' => $description,
|
|
'severity' => 'fail',
|
|
);
|
|
}
|
|
|
|
return array(
|
|
'description' => __( 'Your installation of WordPress does not require FTP credentials to perform updates.' ),
|
|
'severity' => 'pass',
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Checks if core files are writable by the web user/group.
|
|
*
|
|
* @since 5.2.0
|
|
*
|
|
* @global WP_Filesystem_Base $wp_filesystem WordPress filesystem subclass.
|
|
*
|
|
* @return array|false The test results. False if they're not writeable.
|
|
*/
|
|
public function test_all_files_writable() {
|
|
global $wp_filesystem;
|
|
|
|
require ABSPATH . WPINC . '/version.php'; // $wp_version; // x.y.z
|
|
|
|
$skin = new Automatic_Upgrader_Skin();
|
|
$success = $skin->request_filesystem_credentials( false, ABSPATH );
|
|
|
|
if ( ! $success ) {
|
|
return false;
|
|
}
|
|
|
|
WP_Filesystem();
|
|
|
|
if ( 'direct' !== $wp_filesystem->method ) {
|
|
return false;
|
|
}
|
|
|
|
// Make sure the `get_core_checksums()` function is available during our REST API call.
|
|
if ( ! function_exists( 'get_core_checksums' ) ) {
|
|
require_once ABSPATH . 'wp-admin/includes/update.php';
|
|
}
|
|
|
|
$checksums = get_core_checksums( $wp_version, 'en_US' );
|
|
$dev = ( str_contains( $wp_version, '-' ) );
|
|
// Get the last stable version's files and test against that.
|
|
if ( ! $checksums && $dev ) {
|
|
$checksums = get_core_checksums( (float) $wp_version - 0.1, 'en_US' );
|
|
}
|
|
|
|
// There aren't always checksums for development releases, so just skip the test if we still can't find any.
|
|
if ( ! $checksums && $dev ) {
|
|
return false;
|
|
}
|
|
|
|
if ( ! $checksums ) {
|
|
$description = sprintf(
|
|
/* translators: %s: WordPress version. */
|
|
__( "Couldn't retrieve a list of the checksums for WordPress %s." ),
|
|
$wp_version
|
|
);
|
|
$description .= ' ' . __( 'This could mean that connections are failing to WordPress.org.' );
|
|
return array(
|
|
'description' => $description,
|
|
'severity' => 'warning',
|
|
);
|
|
}
|
|
|
|
$unwritable_files = array();
|
|
foreach ( array_keys( $checksums ) as $file ) {
|
|
if ( str_starts_with( $file, 'wp-content' ) ) {
|
|
continue;
|
|
}
|
|
if ( ! file_exists( ABSPATH . $file ) ) {
|
|
continue;
|
|
}
|
|
if ( ! is_writable( ABSPATH . $file ) ) {
|
|
$unwritable_files[] = $file;
|
|
}
|
|
}
|
|
|
|
if ( $unwritable_files ) {
|
|
if ( count( $unwritable_files ) > 20 ) {
|
|
$unwritable_files = array_slice( $unwritable_files, 0, 20 );
|
|
$unwritable_files[] = '...';
|
|
}
|
|
return array(
|
|
'description' => __( 'Some files are not writable by WordPress:' ) . ' <ul><li>' . implode( '</li><li>', $unwritable_files ) . '</li></ul>',
|
|
'severity' => 'fail',
|
|
);
|
|
} else {
|
|
return array(
|
|
'description' => __( 'All of your WordPress files are writable.' ),
|
|
'severity' => 'pass',
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks if the install is using a development branch and can use nightly packages.
|
|
*
|
|
* @since 5.2.0
|
|
*
|
|
* @return array|false The test results. False if it isn't a development version.
|
|
*/
|
|
public function test_accepts_dev_updates() {
|
|
require ABSPATH . WPINC . '/version.php'; // $wp_version; // x.y.z
|
|
// Only for dev versions.
|
|
if ( ! str_contains( $wp_version, '-' ) ) {
|
|
return false;
|
|
}
|
|
|
|
if ( defined( 'WP_AUTO_UPDATE_CORE' ) && ( 'minor' === WP_AUTO_UPDATE_CORE || false === WP_AUTO_UPDATE_CORE ) ) {
|
|
return array(
|
|
'description' => sprintf(
|
|
/* translators: %s: Name of the constant used. */
|
|
__( 'WordPress development updates are blocked by the %s constant.' ),
|
|
'<code>WP_AUTO_UPDATE_CORE</code>'
|
|
),
|
|
'severity' => 'fail',
|
|
);
|
|
}
|
|
|
|
/** This filter is documented in wp-admin/includes/class-core-upgrader.php */
|
|
if ( ! apply_filters( 'allow_dev_auto_core_updates', $wp_version ) ) {
|
|
return array(
|
|
'description' => sprintf(
|
|
/* translators: %s: Name of the filter used. */
|
|
__( 'WordPress development updates are blocked by the %s filter.' ),
|
|
'<code>allow_dev_auto_core_updates</code>'
|
|
),
|
|
'severity' => 'fail',
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks if the site supports automatic minor updates.
|
|
*
|
|
* @since 5.2.0
|
|
*
|
|
* @return array The test results.
|
|
*/
|
|
public function test_accepts_minor_updates() {
|
|
if ( defined( 'WP_AUTO_UPDATE_CORE' ) && false === WP_AUTO_UPDATE_CORE ) {
|
|
return array(
|
|
'description' => sprintf(
|
|
/* translators: %s: Name of the constant used. */
|
|
__( 'WordPress security and maintenance releases are blocked by %s.' ),
|
|
"<code>define( 'WP_AUTO_UPDATE_CORE', false );</code>"
|
|
),
|
|
'severity' => 'fail',
|
|
);
|
|
}
|
|
|
|
/** This filter is documented in wp-admin/includes/class-core-upgrader.php */
|
|
if ( ! apply_filters( 'allow_minor_auto_core_updates', true ) ) {
|
|
return array(
|
|
'description' => sprintf(
|
|
/* translators: %s: Name of the filter used. */
|
|
__( 'WordPress security and maintenance releases are blocked by the %s filter.' ),
|
|
'<code>allow_minor_auto_core_updates</code>'
|
|
),
|
|
'severity' => 'fail',
|
|
);
|
|
}
|
|
}
|
|
}
|