PHP - Function trigger_error()



bool trigger_error ( string $error_msg [, int $error_type] );

Definition and Usage

This function is used to trigger a user error condition, it can be used by 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()).


error_msgRequired. Specifies the error message. Limited to 1024 characters in length.
error_typesOptional. Specifies the error type for this error message.
Possible error types:
  • E_USER_ERROR - Fatal user-generated run-time error. Errors that can not be recovered from. Execution of the script is halted
  • E_USER_WARNING - Non-fatal user-generated run-time warning. Execution of the script is not halted
  • E_USER_NOTICE - Default. User-generated run-time notice. The script found something that might be an error, but could also happen when running a script normally

Return Value

This function returns FALSE if wrong error_type is specified, TRUE otherwise.


Following is the usage of this function:

if (assert($divisor == 0)) {
    trigger_error("Cannot divide by zero :\n", E_USER_ERROR);

This will produce following result:

Fatal error: Cannot divide by zero :
in /var/www/tutorialspoint/php/test.php on line 3