archived-doc-ru/appendices/reserved.constants.core.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 04250271154f102f7aa1d629665a30fdb670b927 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<sect2 xml:id="reserved.constants.core" xmlns="http://docbook.org/ns/docbook">
 <title>Предопределённые константы ядра</title>
 <simpara>
  Эти константы определяет ядро PHP. Сюда входят PHP, движок Zend и SAPI-модули.
 </simpara>
 <variablelist>
  <varlistentry xml:id="constant.php-version">
   <term>
    <constant>PHP_VERSION</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Текущая версия PHP в виде строки в формате
     "major.minor.release[extra]".
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-major-version">
   <term>
    <constant>PHP_MAJOR_VERSION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Текущая «мажорная» версия PHP в виде целого числа
     (например, int(5) для версии "5.2.7-extra").
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-minor-version">
   <term>
    <constant>PHP_MINOR_VERSION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Текущая «минорная» версия PHP в виде целого числа.
     Папример: int(2) для версии "5.2.7-extra".
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-release-version">
   <term>
    <constant>PHP_RELEASE_VERSION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Текущая «точечная» версия PHP в виде целого числа.
     Например: int(7) для версии "5.2.7-extra".
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-version-id">
   <term>
    <constant>PHP_VERSION_ID</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Текущая версия PHP в виде целого числа. Например: int(50207) для версии
     "5.2.7-extra". Целочисленные представления версий проще сравнивать.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-extra-version">
   <term>
    <constant>PHP_EXTRA_VERSION</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Текущая «дополнительная» версия PHP в виде строки. Например:
     "-extra" для версии "5.2.7-extra". Поставщики дистрибутивов
     часто добавляют такой суффикс, чтобы указать версию пакета.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-build-date">
   <term>
    <constant>PHP_BUILD_DATE</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время сборки PHP в формате <literal>"M d Y H:i:s"</literal>. Константа доступна с PHP 8.5.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-build-provider">
   <term>
    <constant>PHP_BUILD_PROVIDER</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Поставщик PHP-сборки. Константа доступна с PHP 8.5.0.
    </simpara>
    <note>
     <simpara>
      Константа доступна в PHP-сборке, только если константу установили при сборке
      из исходного кода и указали значение при конфигурации.
     </simpara>
    </note>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.zend-thread-safe">
   <term>
    <constant>ZEND_THREAD_SAFE</constant>
    (<type>bool</type>)
   </term>
   <listitem>
    <simpara>
     Указывает, потокобезопасна ли текущая сборка PHP.
    </simpara>
    <note>
     <simpara>
      Константа недоступна в сборках PHP для Windows.
     </simpara>
    </note>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.zend-debug-build">
   <term>
    <constant>ZEND_DEBUG_BUILD</constant>
    (<type>bool</type>)
   </term>
   <listitem>
    <simpara>
     Указывает, собрали ли PHP для отладки.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-zts">
   <term>
    <constant>PHP_ZTS</constant>
    (<type>bool</type>)
    &Alias; константы <constant>ZEND_THREAD_SAFE</constant>.
   </term>
   <listitem>
    <simpara>
     Указывает, потокобезопасна ли текущая сборка PHP.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-debug">
   <term>
    <constant>PHP_DEBUG</constant>
    (<type>bool</type>)
    &Alias; константы <constant>ZEND_DEBUG_BUILD</constant>.
   </term>
   <listitem>
    <simpara>
     Указывает, собрали ли PHP для отладки.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.debug-backtrace-provide-object">
   <term>
    <constant>DEBUG_BACKTRACE_PROVIDE_OBJECT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Заполняет индекс «объекта».
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.debug-backtrace-ignore-args">
   <term>
    <constant>DEBUG_BACKTRACE_IGNORE_ARGS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Указывает на невключение информации об аргументах функций в трассировку стека.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-maxpathlen">
   <term>
    <constant>PHP_MAXPATHLEN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Максимальная длина файловых имён (включая путь), которую поддерживает
     сборка PHP.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-os">
   <term>
    <constant>PHP_OS</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Операционная система, под которую собирался PHP.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-os-family">
   <term>
    <constant>PHP_OS_FAMILY</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Семейство операционных систем, для которых собрали PHP.
     Любое из следующих значений:
     <literal>"Windows"</literal>, <literal>"BSD"</literal>,
     <literal>"Darwin"</literal>, <literal>"Solaris"</literal>,
     <literal>"Linux"</literal> или <literal>"unknown"</literal>.
     Константа появилась в PHP 7.2.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-sapi">
   <term>
    <constant>PHP_SAPI</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     API-интерфейс сервера PHP-сборки.
     Смотрите также <function>php_sapi_name</function>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-eol">
   <term>
    <constant>PHP_EOL</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Корректный символ конца строки (End Of Line) для платформы.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-int-max">
   <term>
    <constant>PHP_INT_MAX</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Максимальное целое число, которое поддерживает PHP-сборка.
     Обычно это int(2147483647) в 32-битных системах и int(9223372036854775807) в 64-битных.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-int-min">
   <term>
    <constant>PHP_INT_MIN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Минимальное целое число, которое поддерживает сборка PHP. Обычно это int(-2147483648)
     в 32-битных системах и int(-9223372036854775808) в 64-битных.
     Обычно PHP_INT_MIN === ~PHP_INT_MAX.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-int-size">
   <term>
    <constant>PHP_INT_SIZE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Размер целого числа в байтах в сборке PHP.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-float-dig">
   <term>
    <constant>PHP_FLOAT_DIG</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Количество десятичных цифр, которое PHP умеет округлять до числа
     с плавающей точкой (<type>float</type>) и обратно без потери точности.
     Константа появилась в PHP 7.2.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-float-epsilon">
   <term>
    <constant>PHP_FLOAT_EPSILON</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     Наименьшее представимое положительное число x, для которого
     верно равенство <literal>x + 1.0 != 1.0</literal>.
     Константа появилась в PHP 7.2.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-float-min">
   <term>
    <constant>PHP_FLOAT_MIN</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     Наименьшее представимое <emphasis>положительное</emphasis> число с плавающей точкой <type>float</type>.
     Указывают <literal>- PHP_FLOAT_MAX</literal>, когда требуется наименьшее
     представимое <emphasis>отрицательное</emphasis> число с плавающей точкой <type>float</type>.
     Константа появилась в PHP 7.2.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-float-max">
   <term>
    <constant>PHP_FLOAT_MAX</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     Максимальное представимое число с плавающей точкой <type>float</type>.
     Константа появилась в PHP 7.2.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.default-include-path">
   <term>
    <constant>DEFAULT_INCLUDE_PATH</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pear-install-dir">
   <term>
    <constant>PEAR_INSTALL_DIR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pear-extension-dir">
   <term>
    <constant>PEAR_EXTENSION_DIR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-extension-dir">
   <term>
    <constant>PHP_EXTENSION_DIR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Каталог по умолчанию, в котором PHP будет искать модули для динамической загрузки,
     если только путь не переопределили директивой <link linkend="ini.extension-dir">extension_dir</link>.
     По умолчанию — <constant>PHP_PREFIX</constant> (или <code>PHP_PREFIX . "\\ext"</code> в Windows).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-prefix">
   <term>
    <constant>PHP_PREFIX</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Значение <option role="configure">--prefix</option> установили при конфигурации.
     В ОС Windows при конфигурации установили значение <option role="configure">--with-prefix</option>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-bindir">
   <term>
    <constant>PHP_BINDIR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Значение <option role="configure">--bindir</option> установили при конфигурации.
     В Windows при конфигурации установили значение <option role="configure">--with-prefix</option>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-sbindir">
   <term>
    <constant>PHP_SBINDIR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Значение <option role="configure">--sbindir</option> установили при конфигурации.
     В ОС Windows при конфигурации установили значение
     <option role="configure">--with-prefix</option>. Константа доступна с PHP 8.4.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-binary">
   <term>
    <constant>PHP_BINARY</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Указывает путь к исполняемым PHP-файлам
     во время выполнения скрипта.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-mandir">
   <term>
    <constant>PHP_MANDIR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Указывает, куда установили manpages-страницы руководства.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-libdir">
   <term>
    <constant>PHP_LIBDIR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-datadir">
   <term>
    <constant>PHP_DATADIR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-sysconfdir">
   <term>
    <constant>PHP_SYSCONFDIR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-localstatedir">
   <term>
    <constant>PHP_LOCALSTATEDIR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-config-file-path">
   <term>
    <constant>PHP_CONFIG_FILE_PATH</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-config-file-scan-dir">
   <term>
    <constant>PHP_CONFIG_FILE_SCAN_DIR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-shlib-suffix">
   <term>
    <constant>PHP_SHLIB_SUFFIX</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Суффикс разделяемых (динамических) модулей платформы-сборки,
     например, "s" для большей части Unix-систем
     или "dll" для ОС Windows.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-fd-setsize">
   <term>
    <constant>PHP_FD_SETSIZE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Максимальное количество файловых дескрипторов для системных вызовов.
     Константа появилась в PHP 7.1.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry>
   <term>
    <constant>E_ERROR</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_WARNING</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_PARSE</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_NOTICE</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_CORE_ERROR</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_CORE_WARNING</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_COMPILE_ERROR</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_COMPILE_WARNING</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_USER_ERROR</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_USER_WARNING</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_USER_NOTICE</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_RECOVERABLE_ERROR</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_DEPRECATED</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_USER_DEPRECATED</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_ALL</constant>
    (<type>int</type>)
   </term>
   <term>
    <constant>E_STRICT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <link linkend="errorfunc.constants">Константы сообщений об ошибках</link>
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry>
   <term>
    <constant>__COMPILER_HALT_OFFSET__</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.true">
   <term>
    &true;
    (<type>bool</type>)
   </term>
   <listitem>
    <simpara>
     Смотрите раздел «<link linkend="language.types.boolean">Логические значения</link>».
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.false">
   <term>
    &false;
    (<type>bool</type>)
   </term>
   <listitem>
    <simpara>
     Смотрите раздел «<link linkend="language.types.boolean">Логические значения</link>».
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.null">
   <term>
    &null;
    (<type>null</type>)
   </term>
   <listitem>
    <simpara>
     Смотрите <link linkend="language.types.null">Null</link>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-windows-event-ctrl-c">
     <term>
      <constant>PHP_WINDOWS_EVENT_CTRL_C</constant>
      (<type>int</type>)
     </term>
     <listitem>
      <simpara>
       Событие ОС Windows, которое вызывается сочетанием клавиш
       <keycombo action='simul'>
        <keycap>CTRL</keycap>
        <keycap>C</keycap>
       </keycombo>.
       Константа появилась в PHP 7.4.0 и доступна только в ОС Windows.
      </simpara>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.php-windows-event-ctrl-break">
     <term>
      <constant>PHP_WINDOWS_EVENT_CTRL_BREAK</constant>
      (<type>int</type>)
     </term>
     <listitem>
      <simpara>
       Событие ОС Windows, которое вызывается сочетанием клавиш
       <keycombo action='simul'>
        <keycap>CTRL</keycap>
        <keycap>BREAK</keycap>
       </keycombo>.
       Константа появилась в PHP 7.4.0 и доступна только в ОС Windows.
      </simpara>
     </listitem>
    </varlistentry>
  <varlistentry xml:id="constant.php-cli-process-title">
   <term>
    <constant>PHP_CLI_PROCESS_TITLE</constant>
    (<type>bool</type>)
   </term>
   <listitem>
    <simpara>
     Указывает, доступны ли настройка и получение названия процесса.
     Константа доступна только в CLI-режиме SAPI-интерфейса.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stderr">
   <term>
    <constant>STDERR</constant>
    (<type>resource</type>)
   </term>
   <listitem>
    <simpara>
     Уже открытый поток для стандартного вывода ошибок <literal>stderr</literal>.
     Константа доступна только в CLI-режиме SAPI-интерфейса.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stdin">
   <term>
    <constant>STDIN</constant>
    (<type>resource</type>)
   </term>
   <listitem>
    <simpara>
     Уже открытый поток для стандартного ввода <literal>stdin</literal>.
     Константа доступна только в CLI-режиме SAPI-интерфейса.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stdout">
   <term>
    <constant>STDOUT</constant>
    (<type>resource</type>)
   </term>
   <listitem>
    <simpara>
     Уже открытый поток для стандартного вывода <literal>stdout</literal>.
     Константа доступна только в CLI-режиме SAPI-интерфейса.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>
 <simpara>
  См. также: «<link linkend="language.constants.magic">Магические константы</link>».
 </simpara>
</sect2>
<!-- 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:
-->