PHP: генерация пользовательских ошибок функцией trigger_error

Функция trigger_error в PHP используется для генерации пользовательских ошибок. Она позволяет вручную инициировать ошибки разного уровня в процессе выполнения скрипта. Это удобно для диагностики, отладки или информирования разработчика о проблемах в коде.

# Синтаксис
trigger_error( string $error_message, int $error_type = E_USER_NOTICE ): bool

# E_USER_NOTICE (по умолчанию): Информационное сообщение
# E_USER_WARNING: Предупреждение
# E_USER_ERROR: Фатальная ошибка

Пример использования:

# Информационное сообщение:
trigger_error( "This is just a notice", E_USER_NOTICE );
# > Notice: This is just a notice in /path/to/file.php on line X

# Предупреждение
trigger_error( "This is a warning!", E_USER_WARNING );
# > Warning: This is a warning! in /path/to/file.php on line X

# Фатальная ошибка:
trigger_error( "Fatal error occurred", E_USER_ERROR );
# > Fatal error: Fatal error occurred in /path/to/file.php on line X

# Проверка предусловий или условий выполнения:
if( $data === null )
{
	trigger_error( "Data cannot be null", E_USER_WARNING );
}

# Обработка незначительных ошибок:
if( !is_writable( $file ) )
{
	trigger_error( "File is not writable: $file", E_USER_NOTICE );
}

# Информирование о критических проблемах:
if( !$dbConnection )
{
	trigger_error( "Database connection failed", E_USER_ERROR );
}

Для обработки ошибок, вызванных trigger_error, можно использовать функцию set_error_handler, которая позволяет указать пользовательскую функцию для обработки ошибок.

set_error_handler( function( $errno, $errstr, $errfile, $errline )
{
	echo "Custom Error Handler: [$errno] $errstr in $errfile on line $errline\n";
});
trigger_error( "Custom error", E_USER_NOTICE );