JezK
Edit File: error-protection.php
<?php /** * Error Protection API: Functions * * @package WordPress * @since 5.2.0 */ /** * Get the instance for storing paused plugins. * * @return WP_Paused_Extensions_Storage */ function wp_paused_plugins() { static $storage = null; if ( null === $storage ) { $storage = new WP_Paused_Extensions_Storage( 'plugin' ); } return $storage; } /** * Get the instance for storing paused extensions. * * @return WP_Paused_Extensions_Storage */ function wp_paused_themes() { static $storage = null; if ( null === $storage ) { $storage = new WP_Paused_Extensions_Storage( 'theme' ); } return $storage; } /** * Get a human readable description of an extension's error. * * @since 5.2.0 * * @param array $error Error details from `error_get_last()`. * @return string Formatted error description. */ function wp_get_extension_error_description( $error ) { $constants = get_defined_constants( true ); $constants = $constants['Core'] ?? $constants['internal']; $core_errors = array(); foreach ( $constants as $constant => $value ) { if ( str_starts_with( $constant, 'E_' ) ) { $core_errors[ $value ] = $constant; } } if ( isset( $core_errors[ $error['type'] ] ) ) { $error['type'] = $core_errors[ $error['type'] ]; } /* translators: 1: Error type, 2: Error line number, 3: Error file name, 4: Error message. */ $error_message = __( 'An error of type %1$s was caused in line %2$s of the file %3$s. Error message: %4$s' ); return sprintf( $error_message, "<code>{$error['type']}</code>", "<code>{$error['line']}</code>", "<code>{$error['file']}</code>", "<code>{$error['message']}</code>" ); } /** * Registers the shutdown handler for fatal errors. * * The handler will only be registered if {@see wp_is_fatal_error_handler_enabled()} returns true. * * @since 5.2.0 */ function wp_register_fatal_error_handler() { if ( ! wp_is_fatal_error_handler_enabled() ) { return; } $handler = null; if ( defined( 'WP_CONTENT_DIR' ) && is_readable( WP_CONTENT_DIR . '/fatal-error-handler.php' ) ) { $handler = include WP_CONTENT_DIR . '/fatal-error-handler.php'; } if ( ! is_object( $handler ) || ! is_callable( array( $handler, 'handle' ) ) ) { $handler = new WP_Fatal_Error_Handler(); } register_shutdown_function( array( $handler, 'handle' ) ); } /** * Checks whether the fatal error handler is enabled. * * A constant `WP_DISABLE_FATAL_ERROR_HANDLER` can be set in `wp-config.php` to disable it, or alternatively the * {@see 'wp_fatal_error_handler_enabled'} filter can be used to modify the return value. * * @since 5.2.0 * * @return bool True if the fatal error handler is enabled, false otherwise. */ function wp_is_fatal_error_handler_enabled() { $enabled = ! defined( 'WP_DISABLE_FATAL_ERROR_HANDLER' ) || ! WP_DISABLE_FATAL_ERROR_HANDLER; /** * Filters whether the fatal error handler is enabled. * * **Important:** This filter runs before it can be used by plugins. It cannot * be used by plugins, mu-plugins, or themes. To use this filter you must define * a `$wp_filter` global before WordPress loads, usually in `wp-config.php`. * * Example: * * $GLOBALS['wp_filter'] = array( * 'wp_fatal_error_handler_enabled' => array( * 10 => array( * array( * 'accepted_args' => 0, * 'function' => function() { * return false; * }, * ), * ), * ), * ); * * Alternatively you can use the `WP_DISABLE_FATAL_ERROR_HANDLER` constant. * * @since 5.2.0 * * @param bool $enabled True if the fatal error handler is enabled, false otherwise. */ return apply_filters( 'wp_fatal_error_handler_enabled', $enabled ); } /** * Access the WordPress Recovery Mode instance. * * @since 5.2.0 * * @return WP_Recovery_Mode */ function wp_recovery_mode() { static $wp_recovery_mode; if ( ! $wp_recovery_mode ) { $wp_recovery_mode = new WP_Recovery_Mode(); } return $wp_recovery_mode; }