wpdb::bail() WordPress Method
The wpdb::bail() method is used to gracefully bail out of a database operation when an error occurs. This is useful for making sure that Wordpress doesn't try to go ahead and do something that might end up corrupting the database.
wpdb::bail( string $message, string $error_code = '500' ) #
Wraps errors in a nice header and footer and dies.
Description
Will not die if wpdb::$show_errors is false.
Parameters
- $message
(string)(Required)The error message.
- $error_code
(string)(Optional) A computer-readable string to identify the error.
Default value: '500'
Return
(void|false) Void if the showing of errors is enabled, false if disabled.
Source
File: wp-includes/wp-db.php
public function bail( $message, $error_code = '500' ) { if ( $this->show_errors ) { $error = ''; if ( $this->use_mysqli ) { if ( $this->dbh instanceof mysqli ) { $error = mysqli_error( $this->dbh ); } elseif ( mysqli_connect_errno() ) { $error = mysqli_connect_error(); } } else { if ( is_resource( $this->dbh ) ) { $error = mysql_error( $this->dbh ); } else { $error = mysql_error(); } } if ( $error ) { $message = '<p><code>' . $error . "</code></p>\n" . $message; } wp_die( $message ); } else { if ( class_exists( 'WP_Error', false ) ) { $this->error = new WP_Error( $error_code, $message ); } else { $this->error = $message; } return false; } }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
1.5.0 | Introduced. |