文件管理器

编辑：class-wp-recovery-mode.php

<?php
/**
 * Error Protection API: WP_Recovery_Mode class
 *
 * @package WordPress
 * @since 5.2.0
 */

/**
 * Core class used to implement Recovery Mode.
 *
 * @since 5.2.0
 */
#[AllowDynamicProperties]
class WP_Recovery_Mode {

const EXIT_ACTION = 'exit_recovery_mode';

/**
	 * Service to handle cookies.
	 *
	 * @since 5.2.0
	 * @var WP_Recovery_Mode_Cookie_Service
	 */
	private $cookie_service;

/**
	 * Service to generate a recovery mode key.
	 *
	 * @since 5.2.0
	 * @var WP_Recovery_Mode_Key_Service
	 */
	private $key_service;

/**
	 * Service to generate and validate recovery mode links.
	 *
	 * @since 5.2.0
	 * @var WP_Recovery_Mode_Link_Service
	 */
	private $link_service;

/**
	 * Service to handle sending an email with a recovery mode link.
	 *
	 * @since 5.2.0
	 * @var WP_Recovery_Mode_Email_Service
	 */
	private $email_service;

/**
	 * Is recovery mode initialized.
	 *
	 * @since 5.2.0
	 * @var bool
	 */
	private $is_initialized = false;

/**
	 * Is recovery mode active in this session.
	 *
	 * @since 5.2.0
	 * @var bool
	 */
	private $is_active = false;

/**
	 * Get an ID representing the current recovery mode session.
	 *
	 * @since 5.2.0
	 * @var string
	 */
	private $session_id = '';

/**
	 * WP_Recovery_Mode constructor.
	 *
	 * @since 5.2.0
	 */
	public function __construct() {
		$this->cookie_service = new WP_Recovery_Mode_Cookie_Service();
		$this->key_service    = new WP_Recovery_Mode_Key_Service();
		$this->link_service   = new WP_Recovery_Mode_Link_Service( $this->cookie_service, $this->key_service );
		$this->email_service  = new WP_Recovery_Mode_Email_Service( $this->link_service );
	}

/**
	 * Initialize recovery mode for the current request.
	 *
	 * @since 5.2.0
	 */
	public function initialize() {
		$this->is_initialized = true;

add_action( 'wp_logout', array( $this, 'exit_recovery_mode' ) );
		add_action( 'login_form_' . self::EXIT_ACTION, array( $this, 'handle_exit_recovery_mode' ) );
		add_action( 'recovery_mode_clean_expired_keys', array( $this, 'clean_expired_keys' ) );

if ( ! wp_next_scheduled( 'recovery_mode_clean_expired_keys' ) && ! wp_installing() ) {
			wp_schedule_event( time(), 'daily', 'recovery_mode_clean_expired_keys' );
		}

if ( defined( 'WP_RECOVERY_MODE_SESSION_ID' ) ) {
			$this->is_active  = true;
			$this->session_id = WP_RECOVERY_MODE_SESSION_ID;

return;
		}

if ( $this->cookie_service->is_cookie_set() ) {
			$this->handle_cookie();

return;
		}

$this->link_service->handle_begin_link( $this->get_link_ttl() );
	}

/**
	 * Checks whether recovery mode is active.
	 *
	 * This will not change after recovery mode has been initialized. {@see WP_Recovery_Mode::run()}.
	 *
	 * @since 5.2.0
	 *
	 * @return bool True if recovery mode is active, false otherwise.
	 */
	public function is_active() {
		return $this->is_active;
	}

/**
	 * Gets the recovery mode session ID.
	 *
	 * @since 5.2.0
	 *
	 * @return string The session ID if recovery mode is active, empty string otherwise.
	 */
	public function get_session_id() {
		return $this->session_id;
	}

/**
	 * Checks whether recovery mode has been initialized.
	 *
	 * Recovery mode should not be used until this point. Initialization happens immediately before loading plugins.
	 *
	 * @since 5.2.0
	 *
	 * @return bool
	 */
	public function is_initialized() {
		return $this->is_initialized;
	}

/**
	 * Handles a fatal error occurring.
	 *
	 * The calling API should immediately die() after calling this function.
	 *
	 * @since 5.2.0
	 *
	 * @param array $error Error details from `error_get_last()`.
	 * @return true|WP_Error|void True if the error was handled and headers have already been sent.
	 *                            Or the request will exit to try and catch multiple errors at once.
	 *                            WP_Error if an error occurred preventing it from being handled.
	 */
	public function handle_error( array $error ) {

$extension = $this->get_extension_for_error( $error );

if ( ! $extension || $this->is_network_plugin( $extension ) ) {
			return new WP_Error( 'invalid_source', __( 'Error not caused by a plugin or theme.' ) );
		}

if ( ! $this->is_active() ) {
			if ( ! is_protected_endpoint() ) {
				return new WP_Error( 'non_protected_endpoint', __( 'Error occurred on a non-protected endpoint.' ) );
			}

if ( ! function_exists( 'wp_generate_password' ) ) {
				require_once ABSPATH . WPINC . '/pluggable.php';
			}

return $this->email_service->maybe_send_recovery_mode_email( $this->get_email_rate_limit(), $error, $extension );
		}

if ( ! $this->store_error( $error ) ) {
			return new WP_Error( 'storage_error', __( 'Failed to store the error.' ) );
		}

if ( headers_sent() ) {
			return true;
		}

$this->redirect_protected();
	}

/**
	 * Ends the current recovery mode session.
	 *
	 * @since 5.2.0
	 *
	 * @return bool True on success, false on failure.
	 */
	public function exit_recovery_mode() {
		if ( ! $this->is_active() ) {
			return false;
		}

$this->email_service->clear_rate_limit();
		$this->cookie_service->clear_cookie();

wp_paused_plugins()->delete_all();
		wp_paused_themes()->delete_all();

return true;
	}

/**
	 * Handles a request to exit Recovery Mode.
	 *
	 * @since 5.2.0
	 */
	public function handle_exit_recovery_mode() {
		$redirect_to = wp_get_referer();

// Safety check in case referrer returns false.
		if ( ! $redirect_to ) {
			$redirect_to = is_user_logged_in() ? admin_url() : home_url();
		}

if ( ! $this->is_active() ) {
			wp_safe_redirect( $redirect_to );
			die;
		}

if ( ! isset( $_GET['action'] ) || self::EXIT_ACTION !== $_GET['action'] ) {
			return;
		}

if ( ! isset( $_GET['_wpnonce'] ) || ! wp_verify_nonce( $_GET['_wpnonce'], self::EXIT_ACTION ) ) {
			wp_die( __( 'Exit recovery mode link expired.' ), 403 );
		}

if ( ! $this->exit_recovery_mode() ) {
			wp_die( __( 'Failed to exit recovery mode. Please try again later.' ) );
		}

wp_safe_redirect( $redirect_to );
		die;
	}

/**
	 * Cleans any recovery mode keys that have expired according to the link TTL.
	 *
	 * Executes on a daily cron schedule.
	 *
	 * @since 5.2.0
	 */
	public function clean_expired_keys() {
		$this->key_service->clean_expired_keys( $this->get_link_ttl() );
	}

/**
	 * Handles checking for the recovery mode cookie and validating it.
	 *
	 * @since 5.2.0
	 */
	protected function handle_cookie() {
		$validated = $this->cookie_service->validate_cookie();

if ( is_wp_error( $validated ) ) {
			$this->cookie_service->clear_cookie();

$validated->add_data( array( 'status' => 403 ) );
			wp_die( $validated );
		}

$session_id = $this->cookie_service->get_session_id_from_cookie();
		if ( is_wp_error( $session_id ) ) {
			$this->cookie_service->clear_cookie();

$session_id->add_data( array( 'status' => 403 ) );
			wp_die( $session_id );
		}

$this->is_active  = true;
		$this->session_id = $session_id;
	}

/**
	 * Gets the rate limit between sending new recovery mode email links.
	 *
	 * @since 5.2.0
	 *
	 * @return int Rate limit in seconds.
	 */
	protected function get_email_rate_limit() {
		/**
		 * Filters the rate limit between sending new recovery mode email links.
		 *
		 * @since 5.2.0
		 *
		 * @param int $rate_limit Time to wait in seconds. Defaults to 1 day.
		 */
		return apply_filters( 'recovery_mode_email_rate_limit', DAY_IN_SECONDS );
	}

/**
	 * Gets the number of seconds the recovery mode link is valid for.
	 *
	 * @since 5.2.0
	 *
	 * @return int Interval in seconds.
	 */
	protected function get_link_ttl() {

$rate_limit = $this->get_email_rate_limit();
		$valid_for  = $rate_limit;

/**
		 * Filters the amount of time the recovery mode email link is valid for.
		 *
		 * The ttl must be at least as long as the email rate limit.
		 *
		 * @since 5.2.0
		 *
		 * @param int $valid_for The number of seconds the link is valid for.
		 */
		$valid_for = apply_filters( 'recovery_mode_email_link_ttl', $valid_for );

return max( $valid_for, $rate_limit );
	}

/**
	 * Gets the extension that the error occurred in.
	 *
	 * @since 5.2.0
	 *
	 * @global string[] $wp_theme_directories
	 *
	 * @param array $error Error details from `error_get_last()`.
	 * @return array|false {
	 *     Extension details.
	 *
	 *     @type string $slug The extension slug. This is the plugin or theme's directory.
	 *     @type string $type The extension type. Either 'plugin' or 'theme'.
	 * }
	 */
	protected function get_extension_for_error( $error ) {
		global $wp_theme_directories;

if ( ! isset( $error['file'] ) ) {
			return false;
		}

if ( ! defined( 'WP_PLUGIN_DIR' ) ) {
			return false;
		}

$error_file    = wp_normalize_path( $error['file'] );
		$wp_plugin_dir = wp_normalize_path( WP_PLUGIN_DIR );

if ( str_starts_with( $error_file, $wp_plugin_dir ) ) {
			$path  = str_replace( $wp_plugin_dir . '/', '', $error_file );
			$parts = explode( '/', $path );

return array(
				'type' => 'plugin',
				'slug' => $parts[0],
			);
		}

if ( empty( $wp_theme_directories ) ) {
			return false;
		}

foreach ( $wp_theme_directories as $theme_directory ) {
			$theme_directory = wp_normalize_path( $theme_directory );

if ( str_starts_with( $error_file, $theme_directory ) ) {
				$path  = str_replace( $theme_directory . '/', '', $error_file );
				$parts = explode( '/', $path );

return array(
					'type' => 'theme',
					'slug' => $parts[0],
				);
			}
		}

return false;
	}

/**
	 * Checks whether the given extension a network activated plugin.
	 *
	 * @since 5.2.0
	 *
	 * @param array $extension Extension data.
	 * @return bool True if network plugin, false otherwise.
	 */
	protected function is_network_plugin( $extension ) {
		if ( 'plugin' !== $extension['type'] ) {
			return false;
		}

if ( ! is_multisite() ) {
			return false;
		}

$network_plugins = wp_get_active_network_plugins();

foreach ( $network_plugins as $plugin ) {
			if ( str_starts_with( $plugin, $extension['slug'] . '/' ) ) {
				return true;
			}
		}

return false;
	}

/**
	 * Stores the given error so that the extension causing it is paused.
	 *
	 * @since 5.2.0
	 *
	 * @param array $error Error details from `error_get_last()`.
	 * @return bool True if the error was stored successfully, false otherwise.
	 */
	protected function store_error( $error ) {
		$extension = $this->get_extension_for_error( $error );

if ( ! $extension ) {
			return false;
		}

switch ( $extension['type'] ) {
			case 'plugin':
				return wp_paused_plugins()->set( $extension['slug'], $error );
			case 'theme':
				return wp_paused_themes()->set( $extension['slug'], $error );
			default:
				return false;
		}
	}

/**
	 * Redirects the current request to allow recovering multiple errors in one go.
	 *
	 * The redirection will only happen when on a protected endpoint.
	 *
	 * It must be ensured that this method is only called when an error actually occurred and will not occur on the
	 * next request again. Otherwise it will create a redirect loop.
	 *
	 * @since 5.2.0
	 */
	protected function redirect_protected() {
		// Pluggable is usually loaded after plugins, so we manually include it here for redirection functionality.
		if ( ! function_exists( 'wp_safe_redirect' ) ) {
			require_once ABSPATH . WPINC . '/pluggable.php';
		}

$scheme = is_ssl() ? 'https://' : 'http://';

$url = "{$scheme}{$_SERVER['HTTP_HOST']}{$_SERVER['REQUEST_URI']}";
		wp_safe_redirect( $url );
		exit;
	}
}

名称	权限	大小	修改时间	操作
↑ 返回上级	-	-	-	-
ID3	drwxr-xr-x	-	2024-04-03 10:16	删除
IXR	drwxr-xr-x	-	2026-04-17 05:01	删除
PHPMailer	drwxr-xr-x	-	2025-12-08 18:52	删除
Requests	drwxr-xr-x	-	2023-03-30 09:26	删除
SimplePie	drwxr-xr-x	-	2026-04-17 16:44	删除
Text	drwxr-xr-x	-	2024-11-13 13:00	删除
abilities-api	drwxr-xr-x	-	2026-04-17 16:32	删除
assets	drwxr-xr-x	-	2024-11-13 13:01	删除
block-bindings	drwxr-xr-x	-	2025-12-04 05:41	删除
block-patterns	drwxr-xr-x	-	2024-12-19 23:58	删除
block-supports	drwxr-xr-x	-	2025-12-04 05:41	删除
blocks	drwxr-xr-x	-	2025-12-04 05:41	删除
certificates	drwxr-xr-x	-	2022-11-15 19:03	删除
css	drwxr-xr-x	-	2025-04-16 11:06	删除
customize	drwxr-xr-x	-	2024-11-20 16:49	删除
fonts	drwxr-xr-x	-	2024-04-03 10:16	删除
html-api	drwxr-xr-x	-	2024-12-20 00:03	删除
images	drwxr-xr-x	-	2023-08-09 11:43	删除
interactivity-api	drwxr-xr-x	-	2024-12-20 00:12	删除
js	drwxr-xr-x	-	2025-12-04 05:42	删除
l10n	drwxr-xr-x	-	2024-12-20 00:12	删除
php-compat	drwxr-xr-x	-	2022-11-15 19:03	删除
pomo	drwxr-xr-x	-	2022-11-15 19:03	删除
rest-api	drwxr-xr-x	-	2024-11-20 16:51	删除
sitemaps	drwxr-xr-x	-	2022-11-15 19:03	删除
sodium_compat	drwxr-xr-x	-	2022-11-15 19:03	删除
style-engine	drwxr-xr-x	-	2022-11-15 19:03	删除
theme-compat	drwxr-xr-x	-	2025-12-08 18:51	删除
widgets	drwxr-xr-x	-	2023-06-26 16:12	删除
bookmark-template.php	-rw-r--r--	12.47 KB	2025-04-16 11:06	编辑下载删除
class-smtp.php	-rw-r--r--	457 B	2021-01-26 13:45	编辑下载删除
class-walker-category-dropdown.php	-rw-r--r--	2.41 KB	2023-11-08 10:55	编辑下载删除
class-walker-category.php	-rw-r--r--	8.28 KB	2023-11-08 10:55	编辑下载删除
class-wp-block-bindings-registry.php	-rw-r--r--	8.28 KB	2025-12-04 05:41	编辑下载删除
class-wp-block-bindings-source.php	-rw-r--r--	2.92 KB	2024-11-13 13:01	编辑下载删除
class-wp-block-editor-context.php	-rw-r--r--	1.32 KB	2022-09-12 15:47	编辑下载删除
class-wp-block-list.php	-rw-r--r--	4.6 KB	2025-12-04 05:41	编辑下载删除
class-wp-block-metadata-registry.php	-rw-r--r--	11.62 KB	2025-04-16 11:06	编辑下载删除
class-wp-block-parser-block.php	-rw-r--r--	2.5 KB	2025-12-04 05:41	编辑下载删除
class-wp-block-parser-frame.php	-rw-r--r--	1.97 KB	2024-11-13 13:00	编辑下载删除
class-wp-block-pattern-categories-registry.php	-rw-r--r--	5.32 KB	2025-12-04 05:42	编辑下载删除
class-wp-block-patterns-registry.php	-rw-r--r--	10.99 KB	2026-03-11 06:39	编辑下载删除
class-wp-block-styles-registry.php	-rw-r--r--	6.34 KB	2025-12-04 05:41	编辑下载删除
class-wp-block-templates-registry.php	-rw-r--r--	7.02 KB	2025-12-04 05:41	编辑下载删除
class-wp-block-type-registry.php	-rw-r--r--	4.91 KB	2025-12-04 05:41	编辑下载删除
class-wp-block-type.php	-rw-r--r--	16.86 KB	2024-07-17 11:51	编辑下载删除
class-wp-classic-to-block-menu-converter.php	-rw-r--r--	3.97 KB	2025-12-04 05:41	编辑下载删除
class-wp-customize-control.php	-rw-r--r--	25.51 KB	2025-12-04 05:41	编辑下载删除
class-wp-customize-nav-menus.php	-rw-r--r--	56.65 KB	2025-12-04 05:42	编辑下载删除
class-wp-fatal-error-handler.php	-rw-r--r--	7.96 KB	2024-11-13 13:00	编辑下载删除
class-wp-feed-cache-transient.php	-rw-r--r--	3.23 KB	2025-12-04 05:41	编辑下载删除
class-wp-http-ixr-client.php	-rw-r--r--	3.42 KB	2026-03-11 06:39	编辑下载删除
class-wp-http-requests-hooks.php	-rw-r--r--	1.97 KB	2023-03-30 09:26	编辑下载删除
class-wp-http-requests-response.php	-rw-r--r--	4.3 KB	2023-11-08 10:55	编辑下载删除
class-wp-http-streams.php	-rw-r--r--	16.46 KB	2023-11-08 10:55	编辑下载删除
class-wp-image-editor-gd.php	-rw-r--r--	20.22 KB	2025-12-04 05:41	编辑下载删除
class-wp-image-editor-imagick.php	-rw-r--r--	36.11 KB	2025-12-04 05:41	编辑下载删除
class-wp-list-util.php	-rw-r--r--	7.27 KB	2023-11-08 10:55	编辑下载删除
class-wp-paused-extensions-storage.php	-rw-r--r--	4.99 KB	2024-11-13 13:00	编辑下载删除
class-wp-plugin-dependencies.php	-rw-r--r--	24.72 KB	2025-04-16 11:06	编辑下载删除
class-wp-post-type.php	-rw-r--r--	29.96 KB	2025-04-16 11:06	编辑下载删除
class-wp-post.php	-rw-r--r--	6.34 KB	2025-12-04 05:42	编辑下载删除
class-wp-recovery-mode-cookie-service.php	-rw-r--r--	6.72 KB	2022-10-04 03:59	编辑下载删除
class-wp-recovery-mode-email-service.php	-rw-r--r--	10.92 KB	2023-08-09 11:43	编辑下载删除
class-wp-recovery-mode-key-service.php	-rw-r--r--	4.77 KB	2025-04-16 11:06	编辑下载删除
class-wp-recovery-mode-link-service.php	-rw-r--r--	3.38 KB	2022-09-12 15:47	编辑下载删除
class-wp-recovery-mode.php	-rw-r--r--	11.18 KB	2025-04-16 11:06	编辑下载删除
class-wp-simplepie-file.php	-rw-r--r--	3.47 KB	2025-12-04 05:42	编辑下载删除
class-wp-simplepie-sanitize-kses.php	-rw-r--r--	1.87 KB	2025-04-16 11:06	编辑下载删除
class-wp-text-diff-renderer-inline.php	-rw-r--r--	979 B	2024-04-03 10:16	编辑下载删除
class-wp-text-diff-renderer-table.php	-rw-r--r--	18.44 KB	2025-04-16 11:06	编辑下载删除
class-wp-theme-json-data.php	-rw-r--r--	1.77 KB	2024-07-17 11:51	编辑下载删除
class-wp-theme-json-resolver.php	-rw-r--r--	34.9 KB	2025-04-16 11:06	编辑下载删除
class-wp-theme-json-schema.php	-rw-r--r--	7.19 KB	2024-07-17 11:51	编辑下载删除
class-wp-url-pattern-prefixer.php	-rw-r--r--	4.69 KB	2025-04-16 11:06	编辑下载删除
class-wp-user-meta-session-tokens.php	-rw-r--r--	2.94 KB	2025-12-04 05:42	编辑下载删除
class-wp.php	-rw-r--r--	25.86 KB	2025-12-04 05:41	编辑下载删除
compat.php	-rw-r--r--	17.41 KB	2025-12-04 05:41	编辑下载删除
default-constants.php	-rw-r--r--	11.1 KB	2024-11-13 13:00	编辑下载删除
default-filters.php	-rw-r--r--	37.02 KB	2025-12-04 05:41	编辑下载删除
feed-rdf.php	-rw-r--r--	2.61 KB	2020-01-29 00:45	编辑下载删除
global-styles-and-settings.php	-rw-r--r--	20.71 KB	2025-12-04 05:41	编辑下载删除
http.php	-rw-r--r--	25.27 KB	2025-12-04 05:41	编辑下载删除
link-template.php	-rw-r--r--	156.36 KB	2025-12-04 05:42	编辑下载删除
ms-default-filters.php	-rw-r--r--	6.48 KB	2023-03-30 09:26	编辑下载删除
robots-template.php	-rw-r--r--	5.06 KB	2022-04-06 15:33	编辑下载删除
theme-templates.php	-rw-r--r--	6.09 KB	2025-04-16 11:06	编辑下载删除
vars.php	-rw-r--r--	6.41 KB	2025-04-16 11:06	编辑下载删除