archived-doc-ru/reference/errorfunc/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4c9b6ff9fbc0b2516d21a3f82ad36b91ea1d0aa4 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="errorfunc.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.constants;
 &extension.constants.core;

 <simpara>
  Битовая маска из символических имён или числовых эквивалентов следующих констант
  устанавливает уровень отчёта об ошибках.
  Отчёт о конкретных типах ошибок включается путём установки или сброса битов маски
  при комбинации констант <link linkend="language.operators.bitwise">побитовыми операторами</link>.
 </simpara>

 <tip>
  <simpara>
   В файле &php.ini; вместо буквальных числовых значений
   разрешается указывать названия констант с эквивалентными значениями.
   В файле &php.ini;
   распознаются только побитовые операторы
   <literal>|</literal>,
   <literal>~</literal>,
   <literal>^</literal>,
   <literal>&amp;</literal>
   и оператор отрицания <literal>!</literal>.
  </simpara>
 </tip>

 <warning>
  <simpara>
   Символические имена констант не поддерживаются вне PHP-среды,
   например, в файле &httpd.conf; вместо констант потребуется указать вычисленное значение битовой маски.
  </simpara>
 </warning>

 <variablelist xml:id="errorfunc.constants.errorlevels">
  <varlistentry xml:id="constant.e-error">
   <term>
    <constant>E_ERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Фатальные ошибки времени выполнения. Значение указывает на неустранимые ошибки
     наподобие проблемы выделения памяти.
     При критической ошибке выполнение скрипта прерывается.
    </simpara>
    <simpara>
     Значение константы: <literal>1</literal>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-warning">
   <term>
    <constant>E_WARNING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Предупреждения времени выполнения, некритические ошибки.
     Выполнение скрипта не прерывается.
    </simpara>
    <simpara>
     Значение константы: <literal>2</literal>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-parse">
   <term>
    <constant>E_PARSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Синтаксические ошибки на этапе компиляции.
     Ошибки разбора генерирует только синтаксический анализатор.
    </simpara>
    <simpara>
     Значение константы: <literal>4</literal>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-notice">
   <term>
    <constant>E_NOTICE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Уведомления времени выполнения.
     Значение указывает, что скрипт не нарушает формальные правила синтаксиса и не ломает выполнение программы,
     но содержит возможную ошибку, которая делает результат работы программы непредсказуемым.
    </simpara>
    <simpara>
     Значение константы: <literal>8</literal>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-core-error">
   <term>
    <constant>E_CORE_ERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Фатальные ошибки при запуске и инициализации PHP.
     Ошибки этого уровня аналогичны ошибкам уровня <constant>E_ERROR</constant>,
     но генерируются ядром PHP.
    </simpara>
    <simpara>
     Значение константы: <literal>16</literal>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-core-warning">
   <term>
    <constant>E_CORE_WARNING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Предупреждения при запуске и инициализации PHP, некритические ошибки.
     Ошибки этого уровня аналогичны ошибкам уровня <constant>E_WARNING</constant>,
     но генерируются ядром PHP.
    </simpara>
    <simpara>
     Значение константы: <literal>32</literal>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-compile-error">
   <term>
    <constant>E_COMPILE_ERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Фатальные ошибки на этапе компиляции.
     Ошибки этого уровня аналогичны ошибкам уровня <constant>E_ERROR</constant>,
     но генерируются движком Zend.
    </simpara>
    <simpara>
     Значение константы: <literal>64</literal>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-compile-warning">
   <term>
    <constant>E_COMPILE_WARNING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Предупреждения на этапе компиляции, некритические ошибки.
     Ошибки этого уровня аналогичны ошибкам уровня <constant>E_WARNING</constant>,
     но генерируются движком Zend.
    </simpara>
    <simpara>
     Значение константы: <literal>128</literal>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-deprecated">
   <term>
    <constant>E_DEPRECATED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Уведомления времени выполнения об устаревании.
     Ошибки этого уровня предупреждают о коде,
     который перестанет работать в следующих версиях PHP.
    </simpara>
    <simpara>
     Значение константы: <literal>8192</literal>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-user-error">
   <term>
    <constant>E_USER_ERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Пользовательские сообщения об ошибках.
     Ошибки этого уровня аналогичны ошибкам уровня <constant>E_ERROR</constant>,
     но генерируются в PHP-коде вызовом функции
     <function>trigger_error</function>.
    </simpara>
    <simpara>
     Значение константы: <literal>256</literal>
    </simpara>
    <warning>
     <simpara>
      С PHP 8.4.0 передача константы в функцию <function>trigger_error</function>
      устарела. Альтернатива —
      ключевое слово &throw; и исключения <exceptionname>Exception</exceptionname>
      или вызов функции <function>exit</function>.
     </simpara>
    </warning>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-user-warning">
   <term>
    <constant>E_USER_WARNING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Пользовательские предупреждения.
     Ошибки этого уровня аналогичны ошибкам уровня <constant>E_WARNING</constant>,
     но генерируются в PHP-коде вызовом функции
     <function>trigger_error</function>.
    </simpara>
    <simpara>
     Значение константы: <literal>512</literal>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-user-notice">
   <term>
    <constant>E_USER_NOTICE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Пользовательские уведомления.
     Ошибки этого уровня аналогичны ошибкам уровня <constant>E_NOTICE</constant>,
     но генерируются в PHP-коде вызовом функции
     <function>trigger_error</function>.
    </simpara>
    <simpara>
     Значение константы: <literal>1024</literal>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-user-deprecated">
   <term>
    <constant>E_USER_DEPRECATED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Пользовательские сообщения об устаревании.
     Ошибки этого уровня аналогичны ошибкам уровня <constant>E_DEPRECATED</constant>,
     но генерируются в PHP-коде вызовом функции
     <function>trigger_error</function>.
    </simpara>
    <simpara>
     Значение константы: <literal>16384</literal>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-strict">
   <term>
    <constant>E_STRICT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ошибки времени выполнения. На этом уровне PHP выдаёт предложения об изменениях кода,
     которые повысят совместимость кода с новыми версиями PHP.
    </simpara>
    <simpara>
     Значение константы: <literal>2048</literal>
    </simpara>
    <warning>
     <simpara>
      С PHP 8.4.0 ошибки этого уровня устарели,
      PHP перестал выдавать рекомендации.
     </simpara>
    </warning>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-recoverable-error">
   <term>
    <constant>E_RECOVERABLE_ERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Устаревшие «исключения» движка, которые соответствуют перехватываемым фатальным ошибкам.
     Ошибки этого уровня похожи на ошибки <exceptionname>Error</exceptionname>, но отлавливаются
     пользовательским обработчиком ошибок: <function>set_error_handler</function>.
     Поведение необработанной ошибки этого уровня аналогично поведению ошибок уровня <constant>E_ERROR</constant>.
    </simpara>
    <simpara>
     Значение константы: <literal>4096</literal>
    </simpara>
    <note>
     <simpara>
      PHP фактически не выдаёт ошибки этого уровня,
      единственный пример —
      ошибка при интерпретации внутреннего объекта (&object;) как значения с типом <type>bool</type>.
     </simpara>
     <simpara>
      До PHP 8.4.0 такую ошибку, например, генерировало включение объекта <classname>GMP</classname>
      в условное выражение.
     </simpara>
    </note>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.e-all">
   <term>
    <constant>E_ALL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Битовая маска, которая включает отчёт обо всех ошибках, предупреждениях и уведомлениях.
    </simpara>
    <simpara>
     Значение константы: <literal>30719</literal>
    </simpara>
    <warning>
     <simpara>
      Значение константы до PHP 8.4: <literal>32767</literal>
     </simpara>
    </warning>
   </listitem>
  </varlistentry>

 </variablelist>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->