| layout | default |
|---|---|
| title | WP_CLI::error() |
| description | Display error message prefixed with "Error: " and exit script. |
Docs » Internal API » Output
Display error message prefixed with "Error: " and exit script.
WP_CLI::error( $message, $exit = true )
$message (string|WP_Error) Message to write to STDERR.
$exit (boolean|integer) True defaults to exit(1).
@return (null)
$exit (boolean|integer) True defaults to exit(1).
@return (null)
Error message is written to STDERR. Defaults to halting script execution with return code 1.
Use WP_CLI::warning() instead when script execution should be permitted
to continue.
# `wp cache flush` considers flush failure to be a fatal error.
if ( false === wp_cache_flush() ) {
WP_CLI::error( 'The object cache could not be flushed.' );
}
Internal API documentation is generated from the WP-CLI codebase on every release. To suggest improvements, please submit a pull request.
- WP_CLI\Utils\format_items() - Render a collection of items as an ASCII table, JSON, CSV, YAML, list of ids, or count.
- WP_CLI\Utils\make_progress_bar() - Create a progress bar to display percent completion of a given operation.
- WP_CLI::colorize() - Colorize a string for output.
- WP_CLI::line() - Display informational message without prefix, and ignore `--quiet`.
- WP_CLI::log() - Display informational message without prefix.
- WP_CLI::success() - Display success message prefixed with "Success: ".
- WP_CLI::debug() - Display debug message prefixed with "Debug: " when `--debug` is used.
- WP_CLI::warning() - Display warning message prefixed with "Warning: ".
- WP_CLI::error_multi_line() - Display a multi-line error message in a red box. Doesn't exit script.