Update errorcontrol.xml Infostyle

Author: mmalferov

language/operators/errorcontrol.xml

@@ -5,30 +5,30 @@
  <title>Оператор управления ошибками</title>
  <titleabbrev>Управление ошибками</titleabbrev>
  <simpara>
-  PHP поддерживает один оператор управления ошибками: знак <literal>@</literal>.
-  В случае если он предшествует какому-либо выражению в PHP-коде, любые
-  сообщения об ошибках, генерируемые этим выражением, будут подавлены.
+  PHP поддерживает один оператор управления ошибками: знак <literal>@</literal>,
+  который указывают перед PHP-выражениями. Оператор подавит диагностическую ошибку,
+  которое сгенерировало выражение.
  </simpara>
  <para>
-  Если пользовательская функция обработчика ошибок установлена функцией
-  <function>set_error_handler</function>, она всё равно будет вызываться,
-  даже если диагностика была подавлена.
+  Пользовательская функция обработчика ошибок, которую устанавливают функцией
+  <function>set_error_handler</function>, вызывается,
+  даже если диагностику подавили.
  </para>
  <warning>
   <para>
-  До версии PHP 8.0.0 функция <function>error_reporting</function>,
-  вызываемая внутри пользовательского обработчика ошибок,
-  всегда возвращала <literal>0</literal>, если ошибка была подавлена оператором <literal>@</literal>.
-  Начиная с PHP 8.0.0 она возвращает значение этого (побитового) выражения:
+  До 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>.
-  Результат этой функции будет меняться при каждой ошибке,
-  поэтому его необходимо проверить заранее.
+  Сообщение об ошибке, которое сгенерировало выражение,
+  доступно в элементе с ключом <literal>"message"</literal> в массиве,
+  который возвращает функция <function>error_get_last</function>.
+  Результат функции изменяется при каждой ошибке,
+  поэтому результат лучше проверить заранее.
  </simpara>
  <para>
   <informalexample>
@@ -38,37 +38,37 @@
 
 /* Преднамеренная ошибка при работе с файлами */
 $my_file = @file ('non_existent_file') or
-    die ("Ошибка при открытии файла: сообщение об ошибке было таким: '" . error_get_last()['message'] . "'");
+    die ("При открытии файла возникла ошибка: '" . error_get_last()['message'] . "'");
 
-// работает для любых выражений, а не только для функций
+// Работает с каждым выражением, а не только с функциями
 $value = @$cache[$key];
-// В случае если ключа $key нет, сообщение об ошибке (notice) не будет отображено
+// Уведомление не отобразится, если массив не содержит ключ $key
 
 ]]>
    </programlisting>
   </informalexample>
  </para>
  <note>
   <simpara>
-  Оператор <literal>@</literal> работает только с
-  <link linkend="language.expressions">выражениями</link>.
-  Есть простое правило: если что-то возвращает значение,
-  значит, можно указать перед ним оператор <literal>@</literal>.
-  Например, можно указать оператор <literal>@</literal> перед
-  именем переменной, произвольной функцией,
+  Оператор <literal>@</literal> работает только
+  <link linkend="language.expressions">с выражениями</link>.
+  Простое эмпирическое правило: оператор <literal>@</literal> добавляют перед инструкциями,
+  которые вычисляются как значение.
+  Например, оператор <literal>@</literal> указывают
+  перед названием переменной, произвольной функцией,
   вызовом выражения <function>include</function> и т. д.
-  При этом нельзя указывать этот оператор
-  перед определением функции или класса, условными конструкциями, например:
-  <literal>if</literal>, &foreach; и т. д.
+  При этом нельзя указывать оператор
+  перед определением функции или класса, условными конструкциями наподобие
+  <literal>if</literal>, &foreach; и других.
   </simpara>
  </note>
  <warning>
   <para>
-   До PHP 8.0.0 оператор <literal>@</literal> мог подавлять критические ошибки,
+   До PHP 8.0.0 оператор <literal>@</literal> подавлял критические ошибки,
    которые прерывали выполнение скрипта.
-   Например, добавление оператора <literal>@</literal> к вызову несуществующей функции,
-   когда она недоступна или вызвана с опечаткой,
-   приведёт к прерыванию выполнения скрипта без указания причины.
+   Скрипт завершал выполнение без указания причины,
+   если оператор <literal>@</literal> указывали, например, перед вызовом функции,
+   которую не определили, не импортировали или в названии которой допустили опечатку.
   </para>
  </warning>
  <sect2 role="seealso">