From a415c29efee45520ae252d2aa28f1083a521cd7b Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Wed, 17 Apr 2024 09:56:49 +0200 Subject: Adding upstream version 6.4.3+dfsg1. Signed-off-by: Daniel Baumann --- wp-includes/class-wp-error.php | 316 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 316 insertions(+) create mode 100644 wp-includes/class-wp-error.php (limited to 'wp-includes/class-wp-error.php') diff --git a/wp-includes/class-wp-error.php b/wp-includes/class-wp-error.php new file mode 100644 index 0000000..de72146 --- /dev/null +++ b/wp-includes/class-wp-error.php @@ -0,0 +1,316 @@ +add( $code, $message, $data ); + } + + /** + * Retrieves all error codes. + * + * @since 2.1.0 + * + * @return array List of error codes, if available. + */ + public function get_error_codes() { + if ( ! $this->has_errors() ) { + return array(); + } + + return array_keys( $this->errors ); + } + + /** + * Retrieves the first error code available. + * + * @since 2.1.0 + * + * @return string|int Empty string, if no error codes. + */ + public function get_error_code() { + $codes = $this->get_error_codes(); + + if ( empty( $codes ) ) { + return ''; + } + + return $codes[0]; + } + + /** + * Retrieves all error messages, or the error messages for the given error code. + * + * @since 2.1.0 + * + * @param string|int $code Optional. Error code to retrieve the messages for. + * Default empty string. + * @return string[] Error strings on success, or empty array if there are none. + */ + public function get_error_messages( $code = '' ) { + // Return all messages if no code specified. + if ( empty( $code ) ) { + $all_messages = array(); + foreach ( (array) $this->errors as $code => $messages ) { + $all_messages = array_merge( $all_messages, $messages ); + } + + return $all_messages; + } + + if ( isset( $this->errors[ $code ] ) ) { + return $this->errors[ $code ]; + } else { + return array(); + } + } + + /** + * Gets a single error message. + * + * This will get the first message available for the code. If no code is + * given then the first code available will be used. + * + * @since 2.1.0 + * + * @param string|int $code Optional. Error code to retrieve the message for. + * Default empty string. + * @return string The error message. + */ + public function get_error_message( $code = '' ) { + if ( empty( $code ) ) { + $code = $this->get_error_code(); + } + $messages = $this->get_error_messages( $code ); + if ( empty( $messages ) ) { + return ''; + } + return $messages[0]; + } + + /** + * Retrieves the most recently added error data for an error code. + * + * @since 2.1.0 + * + * @param string|int $code Optional. Error code. Default empty string. + * @return mixed Error data, if it exists. + */ + public function get_error_data( $code = '' ) { + if ( empty( $code ) ) { + $code = $this->get_error_code(); + } + + if ( isset( $this->error_data[ $code ] ) ) { + return $this->error_data[ $code ]; + } + } + + /** + * Verifies if the instance contains errors. + * + * @since 5.1.0 + * + * @return bool If the instance contains errors. + */ + public function has_errors() { + if ( ! empty( $this->errors ) ) { + return true; + } + return false; + } + + /** + * Adds an error or appends an additional message to an existing error. + * + * @since 2.1.0 + * + * @param string|int $code Error code. + * @param string $message Error message. + * @param mixed $data Optional. Error data. Default empty string. + */ + public function add( $code, $message, $data = '' ) { + $this->errors[ $code ][] = $message; + + if ( ! empty( $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 ); + } + + /** + * Adds data to an error with the given code. + * + * @since 2.1.0 + * @since 5.6.0 Errors can now contain more than one item of error data. {@see WP_Error::$additional_data}. + * + * @param mixed $data Error data. + * @param string|int $code Error code. + */ + public function add_data( $data, $code = '' ) { + if ( empty( $code ) ) { + $code = $this->get_error_code(); + } + + if ( isset( $this->error_data[ $code ] ) ) { + $this->additional_data[ $code ][] = $this->error_data[ $code ]; + } + + $this->error_data[ $code ] = $data; + } + + /** + * Retrieves all error data for an error code in the order in which the data was added. + * + * @since 5.6.0 + * + * @param string|int $code Error code. + * @return mixed[] Array of error data, if it exists. + */ + public function get_all_error_data( $code = '' ) { + if ( empty( $code ) ) { + $code = $this->get_error_code(); + } + + $data = array(); + + if ( isset( $this->additional_data[ $code ] ) ) { + $data = $this->additional_data[ $code ]; + } + + if ( isset( $this->error_data[ $code ] ) ) { + $data[] = $this->error_data[ $code ]; + } + + return $data; + } + + /** + * Removes the specified error. + * + * This function removes all error messages associated with the specified + * error code, along with any error data for that code. + * + * @since 4.1.0 + * + * @param string|int $code Error code. + */ + public function remove( $code ) { + unset( $this->errors[ $code ] ); + unset( $this->error_data[ $code ] ); + unset( $this->additional_data[ $code ] ); + } + + /** + * Merges the errors in the given error object into this one. + * + * @since 5.6.0 + * + * @param WP_Error $error Error object to merge. + */ + public function merge_from( WP_Error $error ) { + static::copy_errors( $error, $this ); + } + + /** + * Exports the errors in this object into the given one. + * + * @since 5.6.0 + * + * @param WP_Error $error Error object to export into. + */ + public function export_to( WP_Error $error ) { + static::copy_errors( $this, $error ); + } + + /** + * Copies errors from one WP_Error instance to another. + * + * @since 5.6.0 + * + * @param WP_Error $from The WP_Error to copy from. + * @param WP_Error $to The WP_Error to copy to. + */ + protected static function copy_errors( WP_Error $from, WP_Error $to ) { + foreach ( $from->get_error_codes() as $code ) { + foreach ( $from->get_error_messages( $code ) as $error_message ) { + $to->add( $code, $error_message ); + } + + foreach ( $from->get_all_error_data( $code ) as $data ) { + $to->add_data( $data, $code ); + } + } + } +} -- cgit v1.2.3