balmet.com

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs

error-protection.php (4117B)

      1 <?php
      2 /**
      3  * Error Protection API: Functions
      4  *
      5  * @package WordPress
      6  * @since 5.2.0
      7  */
      8 
      9 /**
     10  * Get the instance for storing paused plugins.
     11  *
     12  * @return WP_Paused_Extensions_Storage
     13  */
     14 function wp_paused_plugins() {
     15 	static $storage = null;
     16 
     17 	if ( null === $storage ) {
     18 		$storage = new WP_Paused_Extensions_Storage( 'plugin' );
     19 	}
     20 
     21 	return $storage;
     22 }
     23 
     24 /**
     25  * Get the instance for storing paused extensions.
     26  *
     27  * @return WP_Paused_Extensions_Storage
     28  */
     29 function wp_paused_themes() {
     30 	static $storage = null;
     31 
     32 	if ( null === $storage ) {
     33 		$storage = new WP_Paused_Extensions_Storage( 'theme' );
     34 	}
     35 
     36 	return $storage;
     37 }
     38 
     39 /**
     40  * Get a human readable description of an extension's error.
     41  *
     42  * @since 5.2.0
     43  *
     44  * @param array $error Error details {@see error_get_last()}
     45  * @return string Formatted error description.
     46  */
     47 function wp_get_extension_error_description( $error ) {
     48 	$constants   = get_defined_constants( true );
     49 	$constants   = isset( $constants['Core'] ) ? $constants['Core'] : $constants['internal'];
     50 	$core_errors = array();
     51 
     52 	foreach ( $constants as $constant => $value ) {
     53 		if ( 0 === strpos( $constant, 'E_' ) ) {
     54 			$core_errors[ $value ] = $constant;
     55 		}
     56 	}
     57 
     58 	if ( isset( $core_errors[ $error['type'] ] ) ) {
     59 		$error['type'] = $core_errors[ $error['type'] ];
     60 	}
     61 
     62 	/* translators: 1: Error type, 2: Error line number, 3: Error file name, 4: Error message. */
     63 	$error_message = __( 'An error of type %1$s was caused in line %2$s of the file %3$s. Error message: %4$s' );
     64 
     65 	return sprintf(
     66 		$error_message,
     67 		"<code>{$error['type']}</code>",
     68 		"<code>{$error['line']}</code>",
     69 		"<code>{$error['file']}</code>",
     70 		"<code>{$error['message']}</code>"
     71 	);
     72 }
     73 
     74 /**
     75  * Registers the shutdown handler for fatal errors.
     76  *
     77  * The handler will only be registered if {@see wp_is_fatal_error_handler_enabled()} returns true.
     78  *
     79  * @since 5.2.0
     80  */
     81 function wp_register_fatal_error_handler() {
     82 	if ( ! wp_is_fatal_error_handler_enabled() ) {
     83 		return;
     84 	}
     85 
     86 	$handler = null;
     87 	if ( defined( 'WP_CONTENT_DIR' ) && is_readable( WP_CONTENT_DIR . '/fatal-error-handler.php' ) ) {
     88 		$handler = include WP_CONTENT_DIR . '/fatal-error-handler.php';
     89 	}
     90 
     91 	if ( ! is_object( $handler ) || ! is_callable( array( $handler, 'handle' ) ) ) {
     92 		$handler = new WP_Fatal_Error_Handler();
     93 	}
     94 
     95 	register_shutdown_function( array( $handler, 'handle' ) );
     96 }
     97 
     98 /**
     99  * Checks whether the fatal error handler is enabled.
    100  *
    101  * A constant `WP_DISABLE_FATAL_ERROR_HANDLER` can be set in `wp-config.php` to disable it, or alternatively the
    102  * {@see 'wp_fatal_error_handler_enabled'} filter can be used to modify the return value.
    103  *
    104  * @since 5.2.0
    105  *
    106  * @return bool True if the fatal error handler is enabled, false otherwise.
    107  */
    108 function wp_is_fatal_error_handler_enabled() {
    109 	$enabled = ! defined( 'WP_DISABLE_FATAL_ERROR_HANDLER' ) || ! WP_DISABLE_FATAL_ERROR_HANDLER;
    110 
    111 	/**
    112 	 * Filters whether the fatal error handler is enabled.
    113 	 *
    114 	 * **Important:** This filter runs before it can be used by plugins. It cannot
    115 	 * be used by plugins, mu-plugins, or themes. To use this filter you must define
    116 	 * a `$wp_filter` global before WordPress loads, usually in `wp-config.php`.
    117 	 *
    118 	 * Example:
    119 	 *
    120 	 *     $GLOBALS['wp_filter'] = array(
    121 	 *         'wp_fatal_error_handler_enabled' => array(
    122 	 *             10 => array(
    123 	 *                 array(
    124 	 *                     'accepted_args' => 0,
    125 	 *                     'function'      => function() {
    126 	 *                         return false;
    127 	 *                     },
    128 	 *                 ),
    129 	 *             ),
    130 	 *         ),
    131 	 *     );
    132 	 *
    133 	 * Alternatively you can use the `WP_DISABLE_FATAL_ERROR_HANDLER` constant.
    134 	 *
    135 	 * @since 5.2.0
    136 	 *
    137 	 * @param bool $enabled True if the fatal error handler is enabled, false otherwise.
    138 	 */
    139 	return apply_filters( 'wp_fatal_error_handler_enabled', $enabled );
    140 }
    141 
    142 /**
    143  * Access the WordPress Recovery Mode instance.
    144  *
    145  * @since 5.2.0
    146  *
    147  * @return WP_Recovery_Mode
    148  */
    149 function wp_recovery_mode() {
    150 	static $wp_recovery_mode;
    151 
    152 	if ( ! $wp_recovery_mode ) {
    153 		$wp_recovery_mode = new WP_Recovery_Mode();
    154 	}
    155 
    156 	return $wp_recovery_mode;
    157 }