<?xml version="1.0" encoding="utf-8"?>

<sect1 xml:id="language.operators.errorcontrol">

<title>Оператор управления ошибками</title>

<titleabbrev>Управление ошибками</titleabbrev>

<simpara>

PHP поддерживает один оператор управления ошибками: знак <literal>@</literal>,

который указывают перед PHP-выражениями. Оператор подавит диагностическую ошибку,

которое сгенерировало выражение.

</simpara>

<para>

Пользовательская функция обработчика ошибок, которую устанавливают функцией

<function>set_error_handler</function>, вызывается,

даже если диагностику подавили.

</para>

<warning>

<para>

До PHP 8.0.0 функция <function>error_reporting</function>

при вызове внутри пользовательского обработчика ошибок

возвращала для ошибок, которые подавили оператором <literal>@</literal>, значение <literal>0</literal>.

Начиная с PHP 8.0.0 функция возвращает значение побитового выражения:

<literal>E_ERROR | E_CORE_ERROR | E_COMPILE_ERROR | E_USER_ERROR | E_RECOVERABLE_ERROR | E_PARSE</literal>.

</para>

</warning>

<simpara>

Сообщение об ошибке, которое сгенерировало выражение,

доступно в элементе с ключом <literal>"message"</literal> в массиве,

который возвращает функция <function>error_get_last</function>.

Результат функции изменяется при каждой ошибке,

поэтому результат лучше проверить заранее.

</simpara>

<para>

<example>

<title>Преднамеренная ошибка считывания файла</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<para>

<example>

<title>Подавление ошибок в выражениях</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<note>

<simpara>

Оператор <literal>@</literal> работает только

<link linkend="language.expressions">с выражениями</link>.

Простое эмпирическое правило: оператор <literal>@</literal> добавляют перед инструкциями,

которые вычисляются как значение.

Оператор <literal>@</literal> указывают

перед названием переменной, произвольной функцией,

вызовом выражения <function>include</function> и т. д.

При этом нельзя указывать оператор

перед определением функции или класса, условными конструкциями наподобие

<literal>if</literal>, циклом &foreach; и другими инструкциями, которые не вычисляются как значение.

</simpara>

</note>

<warning>

<para>

До PHP 8.0.0 оператор <literal>@</literal> подавлял критические ошибки,

которые прерывали выполнение скрипта.

Скрипт завершал выполнение без указания причины,

если оператор <literal>@</literal> указывали, например, перед вызовом функции,

которую не определили, не импортировали или в названии которой допустили опечатку.

</para>

</warning>

<sect2 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>error_reporting</function></member>

<member><link linkend="ref.errorfunc">Обработка ошибок и функции логирования</link></member>

</simplelist>

</para>

</sect2>

</sect1>