(PHP 4 >= 4.0.1, PHP 5, PHP 7)

trigger_errorGenerates 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.



The designated error message for this error. It's limited to 1024 bytes in length. Any additional characters beyond 1024 bytes will be truncated.


The designated error type for this error. It only works with the E_USER family of constants, and will default to E_USER_NOTICE.

Return Values

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.

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.

See Also

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top