%s
', + __( 'This plugin failed to load properly and was paused within the admin backend.' ) + ); + } + + echo ''; break; default: $classes = "$column_name column-$column_name $class"; diff --git src/wp-admin/includes/plugin.php src/wp-admin/includes/plugin.php index c898fc5169..4acf694d0f 100644 --- src/wp-admin/includes/plugin.php +++ src/wp-admin/includes/plugin.php @@ -444,6 +444,8 @@ function _get_dropins() { 'install.php' => array( __( 'Custom installation script.' ), true ), // auto on installation 'maintenance.php' => array( __( 'Custom maintenance message.' ), true ), // auto on maintenance 'object-cache.php' => array( __( 'External object cache.' ), true ), // auto on load + 'php-error.php' => array( __( 'Custom PHP error message.' ), true ), // auto on error + 'shutdown-handler' => array( __( 'Custom PHP shutdown handler.' ), true ), // auto on error ); if ( is_multisite() ) { @@ -496,6 +498,34 @@ function is_plugin_inactive( $plugin ) { return ! is_plugin_active( $plugin ); } +/** + * Determines whether a plugin is technically active but was paused while + * loading. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * + * @since 5.0.0 + * + * @param string $plugin Path to the plugin file relative to the plugins directory. + * + * @return bool True, if in the active plugins list. False, not in the list. + */ +function is_plugin_paused( $plugin ) { + if ( ! isset( $GLOBALS['_paused_plugins'] ) ) { + return false; + } + + if ( ! is_plugin_active( $plugin ) || is_plugin_active_for_network( $plugin ) ) { + return false; + } + + $plugin_path = WP_CONTENT_DIR . '/plugins/' . $plugin; + + return in_array( $plugin_path, $GLOBALS['_paused_plugins'], true ); +} + /** * Determines whether the plugin is active for the entire network. * @@ -693,6 +723,11 @@ function deactivate_plugins( $plugins, $silent = false, $network_wide = null ) { continue; } + // Clean up the database before deactivating the plugin. + if ( is_plugin_paused( $plugin ) ) { + resume_plugin( $plugin ); + } + $network_deactivating = false !== $network_wide && is_plugin_active_for_network( $plugin ); if ( ! $silent ) { @@ -887,6 +922,11 @@ function delete_plugins( $plugins, $deprecated = '' ) { uninstall_plugin( $plugin_file ); } + // Clean up the database before removing the plugin. + if ( is_plugin_paused( $plugin_file ) ) { + resume_plugin( $plugin_file ); + } + /** * Fires immediately before a plugin deletion attempt. * @@ -959,6 +999,44 @@ function delete_plugins( $plugins, $deprecated = '' ) { return true; } +/** + * Resumes a single plugin. + * + * Resuming the plugin basically means removing its entry from the + * `pause_on_admin` database option. + * + * @since 5.0.0 + * + * @param string $plugin Single plugin to resume. + * + * @return bool|WP_Error True on success, false if `$plugin` was not paused, `WP_Error` on failure. + */ +function resume_plugin( $plugin ) { + $pause_on_admin = get_option( 'pause_on_admin', array() ); + + if ( ! array_key_exists( 'plugin', $pause_on_admin ) ) { + return false; + } + + list( $plugin ) = explode( '/', $plugin ); + + if ( ( $index = array_search( $plugin, $pause_on_admin['plugin'], true ) ) !== false ) { + unset( $pause_on_admin['plugin'][ $index ] ); + } + + if ( count( $pause_on_admin['plugin'] ) === 0 ) { + unset( $pause_on_admin['plugin'] ); + } + + $result = update_option( 'pause_on_admin', $pause_on_admin ); + + if ( ! $result ) { + return new WP_Error( 'could_not_resume_plugin', __( 'Could not resume execution of the plugin.' ) ); + } + + return true; +} + /** * Validate active plugins * @@ -2066,3 +2144,36 @@ function wp_add_privacy_policy_content( $plugin_name, $policy_text ) { WP_Privacy_Policy_Content::add( $plugin_name, $policy_text ); } + +/** + * Renders an admin notice in case some plugins have been paused due to errors. + * + * @since 5.0.0 + * + * @return void + */ +function paused_plugins_notice() { + if ( 'plugins.php' === $GLOBALS['pagenow'] ) { + return; + } + + if ( ! current_user_can( 'deactivate_plugins' ) ) { + return; + } + + if ( ! isset( $GLOBALS['_paused_plugins'] ) || empty( $GLOBALS['_paused_plugins'] ) ) { + return; + } + + + echo sprintf( + '%s
%s
%s
deactivated.' ); ?>
resumed.' ); ?>
%s
', + __( 'The site is experiencing technical difficulties.' ) + ); + + if ( function_exists( 'get_admin_url' ) ) { + $url = get_admin_url(); + $message .= sprintf( + '%s %s
', + __( 'Are you the site owner?' ), + $url, + __( 'Log into the admin backend to fix this.' ) + ); + } + + if ( function_exists( 'apply_filters' ) ) { + /** + * Filters the message that the default PHP error page displays. + * + * @since 5.0.0 + * + * @param string $message HTML error message to display. + */ + $message = apply_filters( 'wp_technical_issues_display', $message ); + } + + wp_die( $message ); + } catch ( Exception $exception ) { + // Catch exceptions and remain silent. + } +} + +/** + * Registers the WordPress premature shutdown handler. + * + * @since 5.0.0 + * + * @return void + */ +function wp_register_premature_shutdown_handler() { + register_shutdown_function( 'wp_shutdown_handler_wrapper' ); +} diff --git src/wp-settings.php src/wp-settings.php index eb632238f0..c633f05b1d 100644 --- src/wp-settings.php +++ src/wp-settings.php @@ -20,6 +20,9 @@ require( ABSPATH . WPINC . '/load.php' ); require( ABSPATH . WPINC . '/default-constants.php' ); require_once( ABSPATH . WPINC . '/plugin.php' ); +// Make sure we register the premature shutdown handler as soon as possible. +wp_register_premature_shutdown_handler(); + /* * These can't be directly globalized in version.php. When updating, * we're including version.php from another installation and don't want @@ -40,6 +43,16 @@ global $blog_id; // Set initial default constants including WP_MEMORY_LIMIT, WP_MAX_MEMORY_LIMIT, WP_DEBUG, SCRIPT_DEBUG, WP_CONTENT_DIR and WP_CACHE. wp_initial_constants(); +/* + * Allow an optional shutdown handler to be included through a pluggable file. + * This file should register a function `wp_handle_shutdown( $context )` that + * returns a boolean value. If the return value evaluates to false, the default + * shutdown handler will not be executed. + */ +if ( is_readable( WP_CONTENT_DIR . '/shutdown-handler.php' ) ) { + include WP_CONTENT_DIR . '/shutdown-handler.php'; +} + // Check for the required PHP version and for the MySQL extension or a database drop-in. wp_check_php_mysql_versions(); @@ -482,3 +495,12 @@ if ( is_multisite() ) { * @since 3.0.0 */ do_action( 'wp_loaded' ); + +/* + * Store the fact that we could successfully execute the entire WordPress + * lifecycle. This is used to skip the premature shutdown handler, as it cannot + * be unregistered. + */ +if ( ! defined( 'WP_EXECUTION_SUCCEEDED' ) ) { + define( 'WP_EXECUTION_SUCCEEDED', true ); +}