Changeset 61688

Timestamp:

02/19/2026 10:19:54 AM (3 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.
      */