Changeset 49022 for trunk/src/wp-includes/class-wp-error.php

Timestamp:

09/20/2020 05:43:00 PM (6 years ago)

Author:

johnbillion

Message:

General: Introduce the wp_error_added and wp_error_checked actions.

These actions allow debugging tools to track WP_Error instances as they're created and subsequently passed between functions which check for error objects.

Props Shelob9, Mte90, TimothyBlynJacobs, johnbillion

Fixes #40568

File:

• trunk/src/wp-includes/class-wp-error.php (modified) (3 diffs)

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

@@ -57 +57 @@
                 }
 
-                $this->errors[ $code ][] = $message;
-
-                if ( ! empty( $data ) ) {
-                        $this->error_data[ $code ] = $data;
-                }
+                $this->add( $code, $message, $data );
         }
 
@@ -177 +173 @@
 
         /**
-         * Add an error or append additional message to an existing error.
+         * Adds an error or appends an additional message to an existing error.
          *
          * @since 2.1.0
@@ -187 +183 @@
         public function add( $code, $message, $data = '' ) {
                 $this->errors[ $code ][] = $message;
+
                 if ( ! empty( $data ) ) {
-                        $this->error_data[ $code ] = $data;
-                }
+                        $this->add_data( $data, $code );
+                }
+
+                /**
+                 * Fires when an error is added to a WP_Error object.
+                 *
+                 * @since 5.6.0
+                 *
+                 * @param string|int $code     Error code.
+                 * @param string     $message  Error message.
+                 * @param mixed      $data     Error data. Might be empty.
+                 * @param WP_Error   $wp_error The WP_Error object.
+                 */
+                do_action( 'wp_error_added', $code, $message, $data, $this );
         }