trigger_error Generates a user-level error/warning/notice message &reftitle.description; truetrigger_error stringmessage interror_levelE_USER_NOTICE 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. &reftitle.parameters; message 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_level The designated error type for this error. It only works with the E_USER_* family of constants, and will default to E_USER_NOTICE. Passing E_USER_ERROR as the error_level is now deprecated. Throw an Exception or call exit instead. &reftitle.returnvalues; &return.true.always; &reftitle.errors; This function throws a ValueError if error_level is not one of E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE, E_USER_DEPRECATED. &reftitle.changelog; &Version; &Description; 8.4.0 Passing E_USER_ERROR as the error_level is now deprecated. Throw an Exception or call exit instead. 8.4.0 The function now has a return type of true instead of bool. 8.0.0 The function now throws a ValueError if an invalid error_level is specified. Previously, it returned &false;. &reftitle.examples; <function>trigger_error</function> example See set_error_handler for a more extensive example. ]]> &reftitle.notes; HTML entities in message are not escaped. Use htmlentities on the message if the error is to be displayed in a browser. &reftitle.seealso; error_reporting set_error_handler restore_error_handler The error level constants The Deprecated attribute