WP_Fatal_Error_Handler

19#[AllowDynamicProperties]20class WP_Fatal_Error_Handler {21 22	/**23	 * Runs the shutdown handler.24	 *25	 * This method is registered via `register_shutdown_function()`.26	 *27	 * @since 5.2.028	 *29	 * @global WP_Locale $wp_locale WordPress date and time locale object.30	 */31	public function handle() {32		if ( defined( 'WP_SANDBOX_SCRAPING' ) && WP_SANDBOX_SCRAPING ) {33			return;34		}35 36		// Do not trigger the fatal error handler while updates are being installed.37		if ( wp_is_maintenance_mode() ) {38			return;39		}40 41		try {42			// Bail if no error found.43			$error = $this->detect_error();44			if ( ! $error ) {45				return;46			}47 48			if ( ! isset( $GLOBALS['wp_locale'] ) && function_exists( 'load_default_textdomain' ) ) {49				load_default_textdomain();50			}51 52			$handled = false;53 54			if ( ! is_multisite() && wp_recovery_mode()->is_initialized() ) {55				$handled = wp_recovery_mode()->handle_error( $error );56			}57 58			// Display the PHP error template if headers not sent.59			if ( is_admin() || ! headers_sent() ) {60				$this->display_error_template( $error, $handled );61			}62		} catch ( Exception $e ) {63			// Catch exceptions and remain silent.64		}65	}66 67	/**68	 * Detects the error causing the crash if it should be handled.69	 *70	 * @since 5.2.071	 *72	 * @return array|null Error information returned by `error_get_last()`, or null73	 *                    if none was recorded or the error should not be handled.74	 */75	protected function detect_error() {76		$error = error_get_last();77 78		// No error, just skip the error handling code.79		if ( null === $error ) {80			return null;81		}82 83		// Bail if this error should not be handled.84		if ( ! $this->should_handle_error( $error ) ) {85			return null;86		}87 88		return $error;89	}90 91	/**92	 * Determines whether we are dealing with an error that WordPress should handle93	 * in order to protect the admin backend against WSODs.94	 *95	 * @since 5.2.096	 *97	 * @param array $error Error information retrieved from `error_get_last()`.98	 * @return bool Whether WordPress should handle this error.