(PHP 4 >= 4.0.1, PHP 5, PHP 7)
trigger_error — Generates a user-level error/warning/notice message
trigger_error ( string $error_msg [, int $error_type = E_USER_NOTICE ] ) : bool
Used to trigger a user error condition, it can be used in conjunction with the built-in error handler, or with a user defined function that has been set as the new error handler (set_error_handler()).
This function is useful when you need to generate a particular response to an exception at runtime.
error_msg
The designated error message for this error. It's limited to 1024 bytes in length. Any additional characters beyond 1024 bytes will be truncated.
error_type
The designated error type for this error. It only works with the E_USER family of constants, and will default to E_USER_NOTICE
.
This function returns false
if wrong error_type
is specified, true
otherwise.
Example #1 trigger_error() example
See set_error_handler() for a more extensive example.
<?php if ($divisor == 0) { trigger_error("Cannot divide by zero", E_USER_ERROR); } ?>
HTML entities in error_msg
are not escaped. Use htmlentities() on the message if the error is to be displayed in a browser.
© 1997–2020 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/function.trigger-error.php