trigger_error
Генерирует предупреждение, уведомление или сообщение об ошибке на уровне пользователя
&reftitle.description;
truetrigger_errorstringmessageinterror_levelE_USER_NOTICE
Функция инициирует состояние пользовательской ошибки. Функцию разрешается использовать
в сочетании со встроенным обработчиком ошибок или функцией,
которую разработчик определил и установил через функцию
set_error_handler как новый обработчик ошибок.
Польза функции проявляется при выполнении кода, когда
требуется сгенерировать конкретный ответ на исключение.
&reftitle.parameters;
message
Сообщение, которое функция назначит ошибке. Длина сообщения ограничивается
1024 байтами. Функция обрежет символы, которые идут после 1024-го.
error_level
Тип, который функция назначит ошибке. Параметр работает только
с константами семейства E_USER_*,
а значение по умолчанию равно E_USER_NOTICE.
Передача константы E_USER_ERROR как значения уровня ошибки
в параметр error_level устарела.
Вместо этого рекомендуют выбрасывать исключение Exception
или вызывать функцию exit.
&reftitle.returnvalues;
&return.true.always;
&reftitle.errors;
Функция выбрасывает исключение ValueError,
если значение параметра error_level не соответствует значениям
E_USER_ERROR, E_USER_WARNING,
E_USER_NOTICE или E_USER_DEPRECATED.
&reftitle.changelog;
&Version;&Description;8.4.0
Передача константы E_USER_ERROR как значения уровня ошибки
в параметр error_level устарела.
Вместо этого рекомендуют выбрасывать исключение Exception
или вызывать функцию exit.
8.4.0
Вместо типа bool
функции теперь возвращает тип true.
8.0.0
Функция выбрасывает ошибку ValueError,
если в аргументе error_level передали недопустимое значение.
Раньше функция возвращала значение &false;.
&reftitle.examples;
Пример запуска состояния пользовательской ошибки функцией <function>trigger_error</function>
Развёрнутый пример приводит описание
функции set_error_handler.
]]>
&reftitle.notes;
HTML-сущности в параметре message не экранируются.
Сообщение преобразовывают функцией htmlentities,
если ошибку требуется отобразить в браузере.
&reftitle.seealso;
error_reportingset_error_handlerrestore_error_handlerКонстанты уровней ошибок