Changeset 61688

Timestamp:

02/19/2026 10:19:54 AM (8 months ago)

Author:

audrasjb

Message:

General: Allow to hook into wp_trigger_error() when WP_DEBUG is not truthy.

This changeset allow developers to attach custom error handlers into wp_trigger_error() even if WP_DEBUG is not truthy.
It introduces two new hooks, making wp_trigger_error() consistent with what is available in _doing_it_wrong:

• wp_trigger_error_always_run always fires when the given function triggers a user-level error/warning/notice/deprecation message.
• wp_trigger_error_trigger_error filters whether to trigger the error.

Props kkmuffme, swissspidy, audrasjb.
Fixes #60886.

File:

• trunk/src/wp-includes/functions.php (modified) (2 diffs)

trunk/src/wp-includes/functions.php

@@ -6090 +6090 @@
  */
 function wp_trigger_error( $function_name, $message, $error_level = E_USER_NOTICE ) {
+        /**
+         * Always fires when the given function triggers a user-level error/warning/notice/deprecation message.
+         *
+         * Can be used to attach custom error handlers even if WP_DEBUG is not truthy.
+         *
+         * @since 7.0.0
+         *
+         * @param string $function_name The function that triggered the error.
+         * @param string $message       The message explaining the error.
+         * @param int    $error_level   The designated error type for this error.
+         */
+        do_action( 'wp_trigger_error_always_run', $function_name, $message, $error_level );
+
+        /**
+         * Filters whether to trigger an error.
+         *
+         * @since 7.0.0
+         *
+         * @param bool   $trigger       Whether to trigger the error. Default true.
+         * @param string $function_name The function that triggered the error.
+         * @param string $message       The message explaining the error.
+         * @param int    $error_level   The designated error type for this error.
+         */
+        if ( ! apply_filters( 'wp_trigger_error_trigger_error', true, $function_name, $message, $error_level ) ) {
+                return;
+        }
 
         // Bail out if WP_DEBUG is not turned on.
@@ -6103 +6129 @@
          * @since 6.4.0
          *
-         * @param string $function_name The function that was called.
-         * @param string $message       A message explaining what has been done incorrectly.
+         * @param string $function_name The function that triggered the error.
+         * @param string $message       The message explaining the error.
          * @param int    $error_level   The designated error type for this error.
          */