Changeset 49489 for trunk/src/wp-includes/error-protection.php

Timestamp:

11/03/2020 05:34:20 PM (4 years ago)

Author:

johnbillion

Message:

Docs: Add more information about how to use filters that run before WordPress initialises.

Fixes #50134

File:

• trunk/src/wp-includes/error-protection.php (modified) (1 diff)

trunk/src/wp-includes/error-protection.php

@@ -112 +112 @@
      * 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
      *