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

<!-- EN-Revision: a52e3d27cca786940272d0ae8efc21b5d6739070 Maintainer: mch Status: ready -->

<!-- Reviewed: no -->

<section xml:id="ini.core" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<title>Описание встроенных директив &php.ini;</title>

<para>

Список включает встроенные директивы файла &php.ini;, которыми настраивают PHP.

Директивы, которые обрабатываются модулями, перечисляют и подробно

описывают страницы документации модулей.

Например, информацию о директивах сессий даёт

<link linkend="session.configuration">страница документации сессий</link>.

</para>

<note>

<para>

PHP работает со значениями по умолчанию, только если не подключили файл &php.ini;;

значения файла &php.ini; для производственной среды

и для разработки часто различаются.

</para>

</note>

<section xml:id="ini.sect.language-options">

<title>Языковые опции</title>

<para>

<table>

<title>Опции языка и прочих настроек</title>

<tgroup cols="4">

<thead>

<row>

<entry>&Name;</entry>

<entry>&Default;</entry>

<entry>&Changeable;</entry>

<entry>&Changelog;</entry>

</row>

</thead>

<tbody>

<row>

<entry><link linkend="ini.short-open-tag">short_open_tag</link></entry>

<entry>"1"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.precision">precision</link></entry>

<entry>"14"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.serialize-precision">serialize_precision</link></entry>

<entry>"-1"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry>

До версии PHP 7.1.0 значение по умолчанию равнялось 17.

</entry>

</row>

<row>

<entry><link linkend="ini.disable-functions">disable_functions</link></entry>

<entry>""</entry>

<entry>Только <constant>INI_SYSTEM</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.disable-classes">disable_classes</link></entry>

<entry>""</entry>

<entry>Только &php.ini;</entry>

<entry>В PHP 8.5.0 директиву удалили.</entry>

</row>

<row>

<entry><link linkend="ini.exit-on-timeout">exit_on_timeout</link></entry>

<entry>""</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.expose-php">expose_php</link></entry>

<entry>"1"</entry>

<entry>Только &php.ini;</entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.hard-timeout">hard_timeout</link></entry>

<entry>"2"</entry>

<entry><constant>INI_SYSTEM</constant></entry>

<entry>Опция доступна с PHP 7.1.0.</entry>

</row>

<row>

<entry><link linkend="ini.zend.exception-ignore-args">zend.exception_ignore_args</link></entry>

<entry>"0"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry>Опция доступна с PHP 7.4.0</entry>

</row>

<row>

<entry><link linkend="ini.zend.multibyte">zend.multibyte</link></entry>

<entry>"0"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.script-encoding">zend.script_encoding</link></entry>

<entry>NULL</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.detect-unicode">zend.detect_unicode</link></entry>

<entry>NULL</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.signal-check">zend.signal_check</link></entry>

<entry>"0"</entry>

<entry><constant>INI_SYSTEM</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.assertions">zend.assertions</link></entry>

<entry>"1"</entry>

<entry><constant>INI_ALL</constant> с ограничениями</entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.exception-string-param-max-len">zend.exception_string_param_max_len</link></entry>

<entry>"15"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry>Опция доступна с PHP 8.0.0.</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.short-open-tag">

<term>

<parameter>short_open_tag</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Опция включает или отключает короткую форму записи открывающего PHP-тега: <userinput>&lt;? ?&gt;</userinput>.

Опцию отключают при встраивании XML-разметки в PHP-скрипт, чтобы синтаксический анализатор не интерпретировал

первые два символа XML-декларации <userinput>&lt;?xml ?&gt;</userinput> как короткий PHP-тег.

При включённой директиве XML-декларацию выводят средствами PHP, например:

<userinput>&lt;?php echo '&lt;?xml version="1.0"?&gt;'; ?&gt;</userinput>.

При отключении опции в режим разбора PHP-кода переключаются длинной формой

открывающего PHP-тега: <userinput>&lt;?php ?&gt;</userinput>.

</para>

<note>

<para>

Директива не влияет на сокращённую запись <userinput>&lt;?=</userinput>,

которая доступна как часть синтаксиса языка.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.precision">

<term>

<parameter>precision</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

Количество значащих цифр, отображаемых для чисел с плавающей точкой.

Значение <literal>-1</literal> включает усовершенствованный алгоритм

для округления таких чисел.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.serialize-precision">

<term>

<parameter>serialize_precision</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

Количество сохраняемых значащих цифр при сериализации чисел с плавающей точкой.

Значение <literal>-1</literal> включает усовершенствованный алгоритм

для округления таких чисел.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.expose-php">

<term>

<parameter>expose_php</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Опция сообщает о работе PHP на сервере, включая передачу версии PHP

в HTTP-заголовке наподобие X-Powered-By: PHP/5.3.7.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.disable-functions">

<term>

<parameter>disable_functions</parameter>

<type>string</type>

</term>

<listitem>

<simpara>

Директива отключает отдельные функции. Опция принимает разделённый запятыми список названий функций.

Начиная с PHP 8.0.0 отключение функции удаляет определение функции

и разрешает переопределить функцию в пользовательском коде.

До PHP 8.0.0 отключение функции только предотвращало вызов функции.

</simpara>

<simpara>

Директива отключает только <link linkend="functions.internal">внутренние функции</link>.

Функция не затрагивает <link linkend="functions.user-defined">пользовательские функции</link>.

</simpara>

<simpara>

Директиву устанавливают только в файле &php.ini;.

Опцию нельзя устанавливать в файле &httpd.conf;.

</simpara>

<warning>

<simpara>

В окружениях общих хостингов директива даёт недостаточный уровень защиты,

поскольку отключённые функции возможно вызывать обходными путями.

</simpara>

</warning>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.disable-classes">

<term>

<parameter>disable_classes</parameter>

<type>string</type>

</term>

<listitem>

<simpara>

Директива отключает отдельные классы.

Опция принимает разделённый запятыми список названий классов.

Отключение класса только запрещает создавать экземпляр класса.

</simpara>

<simpara>

Директива отключает только внутренние классы.

Опция не затрагивает пользовательские классы.

</simpara>

<simpara>

Директиву устанавливают только в файле &php.ini;.

Опцию нельзя устанавливать в файле &httpd.conf;.

</simpara>

<warning>

<simpara>

В окружениях общих хостингов директива даёт недостаточный уровень защиты,

поскольку объекты отключённых классов возможно создать обходными путями.

</simpara>

</warning>

&warn.removed.feature-8-5-0;

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.assertions">

<term>

<parameter>zend.assertions</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

Со значением <literal>1</literal> проверочный код будет исполняться (режим

разработки). При значении <literal>0</literal> PHP сгенерирует код проверок, однако,

исполнять не будет. Со значением <literal>-1</literal>, проверочный код не будет

генерироваться (продуктивный режим).

</simpara>

<note>

<para>

При запуске процесса в режиме релиза значение директивы <link linkend="ini.zend.assertions">zend.assertions</link>

нельзя будет изменить во время выполнения, поскольку код утверждений не генерируется.

</para>

<para>

При запуске процесса в режиме разработки для директивы <link linkend="ini.zend.assertions">zend.assertions</link>

нельзя будет установить значение <literal>-1</literal> во время выполнения.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.exception-string-param-max-len">

<term>

<parameter>zend.exception_string_param_max_len</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

Максимальная длина аргументов строковой функции в строковых трассировках стека.

Опиция принимает значение в диапазоне от <literal>"0"</literal> до <literal>"1000000"</literal>.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.hard-timeout">

<term>

<parameter>hard_timeout</parameter>

<type>int</type>

</term>

<listitem>

<para>

После истечения времени ожидания, которое установили в директиве <link linkend="ini.max-execution-time">max_execution_time</link>,

среда выполнения PHP аккуратно отключит ресурсы. Если во время этого что-то застрянет, время ожидания

установится на заданное количество секунд. После истечения жёсткого времени ожидания PHP завершит работу с ошибкой.

При установке значения 0 жёсткое время ожидания не активируется.

</para>

<para>

После истечения жёсткого времени ожидания и остановки PHP возникает ошибка наподобие:

<screen>

<![CDATA[

Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unknown on line 0

]]>

</screen>

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.exception-ignore-args">

<term>

<parameter>zend.exception_ignore_args</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Исключает аргументы из трассировки стека, которая генерируется при исключениях.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.multibyte">

<term>

<parameter>zend.multibyte</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Директива разрешает разбор файлов с исходным кодом в многобайтовых кодировках.

Опцию zend.multibyte включают для правильной интерпретации многобайтовых строковых данных

в кодировках символов наподобие SJIS, BIG5.

Для файлов в кодировках UTF-8, EUC и других совместимых с ISO-8859-1 кодировках активация опции не требуется.

</para>

<para>

Режим разбора, который активируется директивой zend.multibyte, работает только при доступности модуля mbstring.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.script-encoding">

<term>

<parameter>zend.script_encoding</parameter>

<type>string</type>

</term>

<listitem>

<para>

PHP применяет значение только при отсутствии директивы

<link linkend="control-structures.declare.encoding">declare(encoding=...)</link>

в начале скрипта. В кодировках, которые несовместимы с кодировкой ISO-8859-1,

требуется включить и опцию zend.multibyte, и опцию zend.script_encoding.

</para>

<para>

Литеральные строки транслитерируются из кодировки директивы zend.script_encoding

в кодировку директивы mbstring.internal_encoding, как если бы вызвали функцию <function>mb_convert_encoding</function>.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.detect-unicode">

<term>

<parameter>zend.detect_unicode</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Определяет, проверять ли BOM (Byte Order Mark, метка порядка байтов)

и корректность многобайтных символов в файле. Эта проверка производится до вызова

<function>__halt_compiler</function>. Доступна только в режиме Zend Multibyte.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.signal-check">

<term>

<parameter>zend.signal_check</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Определяет, проверять ли заменённые обработчики сигналов при завершении скрипта.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.exit-on-timeout">

<term>

<parameter>exit_on_timeout</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Директива работает только с модулем mod_php веб-сервера Apache1 и заставляет дочерний процесс Apache

завершить работу при истечении времени ожидания выполнения PHP-скрипта. Превышение времени ожидания приводит

к внутреннему вызову longjmp() в Apache1, который оставляет отдельные модули

в несогласованном состоянии. По завершении процесса все неснятые блокировки

или память очистятся.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</section>

<section xml:id="ini.sect.resource-limits">

<title>Ограничения ресурсов</title>

<para>

<table>

<title>Ограничения ресурсов</title>

<tgroup cols="4">

<thead>

<row>

<entry>&Name;</entry>

<entry>&Default;</entry>

<entry>&Changeable;</entry>

<entry>&Changelog;</entry>

</row>

</thead>

<tbody>

<row>

<entry><link linkend="ini.memory-limit">memory_limit</link></entry>

<entry>"128M"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

</tbody>

</tgroup>

</table>

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.memory-limit">

<term>

<parameter>memory_limit</parameter>

<type>int</type>

</term>

<listitem>

<para>

Директива задаёт предельный объем памяти в байтах, который разрешается выделять для работы скрипта.

Ограничение исключает исчерпание доступной серверу памяти при ошибках в скрипте или попытках обработать данные за пределами ограничения.

Значение <literal>-1</literal> отключает ограничение памяти.

</para>

&ini.shorthandbytes;

</listitem>

</varlistentry>

</variablelist>

</para>

<para>

Смотрите также описание директивы: <link linkend="ini.max-execution-time">max_execution_time</link>.

</para>

</section>

<section xml:id="ini.sect.performance">

<title>Настройка производительности</title>

<para>

<table>

<title>Настройка производительности</title>

<tgroup cols="4">

<thead>

<row>

<entry>&Name;</entry>

<entry>&Default;</entry>

<entry>&Changeable;</entry>

<entry>&Changelog;</entry>

</row>

</thead>

<tbody>

<row>

<entry><link linkend="ini.realpath-cache-size">realpath_cache_size</link></entry>

<entry>"4M"</entry>

<entry><constant>INI_SYSTEM</constant></entry>

<entry>До PHP 7.0.16 и 7.1.2 значение по умолчанию равнялось <literal>"16K"</literal></entry>

</row>

<row>

<entry><link linkend="ini.realpath-cache-ttl">realpath_cache_ttl</link></entry>

<entry>"120"</entry>

<entry><constant>INI_SYSTEM</constant></entry>

<entry></entry>

</row>

</tbody>

</tgroup>

</table>

<note>

<para>

Директива <link linkend="ini.open-basedir">open_basedir</link>

<emphasis>отключит</emphasis> кеш realpath.

</para>

</note>

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.realpath-cache-size">

<term>

<parameter>realpath_cache_size</parameter>

<type>int</type>

</term>

<listitem>

<para>

Директива определяет размера кеша realpath, который будет использовать PHP. Это значение

требуется увеличить в системах, в которых PHP открывает много

файлов, чтобы отразить количество файловых операций, которые выполнил PHP.

</para>

<para>

Размер — общее количество байтов в сохранённых строках путей, плюс размер данных,

которые связаны с записью кеша. Это значит, что для хранения длинных путей в кеше,

размер этого кеша должен быть больше. Это значение не определяет напрямую

количество разных путей, которые PHP может закешировать.

</para>

<para>

Размер, который требуется для кеширования, зависит от системы.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.realpath-cache-ttl">

<term>

<parameter>realpath_cache_ttl</parameter>

<type>int</type>

</term>

<listitem>

<para>

Время в секундах, в течение которого PHP обращается в realpath-кеш

для файла или каталога. Для систем, в которых файлы изменяются редко,

значение увеличивают.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</section>

<section xml:id="ini.sect.data-handling">

<title>Обработка данных</title>

<para>

<table>

<title>Конфигурационные опции обработки данных</title>

<tgroup cols="4">

<thead>

<row>

<entry>&Name;</entry>

<entry>&Default;</entry>

<entry>&Changeable;</entry>

<entry>&Changelog;</entry>

</row>

</thead>

<tbody>

<row>

<entry><link linkend="ini.arg-separator.output">arg_separator.output</link></entry>

<entry>"&amp;"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.arg-separator.input">arg_separator.input</link></entry>

<entry>"&amp;"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.variables-order">variables_order</link></entry>

<entry>"EGPCS"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.request-order">request_order</link></entry>

<entry>""</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.auto-globals-jit">auto_globals_jit</link></entry>

<entry>"1"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry>

<entry>"1"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry>С PHP 8.5.0 директива устарела.</entry>

</row>

<row>

<entry><link linkend="ini.enable-post-data-reading">enable_post_data_reading</link></entry>

<entry>"1"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.post-max-size">post_max_size</link></entry>

<entry>"8M"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.auto-prepend-file">auto_prepend_file</link></entry>

<entry>NULL</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.auto-append-file">auto_append_file</link></entry>

<entry>NULL</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.default-mimetype">default_mimetype</link></entry>

<entry>"text/html"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.default-charset">default_charset</link></entry>

<entry>"UTF-8"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.input-encoding">input_encoding</link></entry>

<entry>""</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.output-encoding">output_encoding</link></entry>

<entry>""</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.internal-encoding">internal_encoding</link></entry>

<entry>""</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

</tbody>

</tgroup>

</table>

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.arg-separator.output">

<term>

<parameter>arg_separator.output</parameter>

<type>string</type>

</term>

<listitem>

<para>

Разделитель аргументов в URL-адресах, которые генерирует PHP.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.arg-separator.input">

<term>

<parameter>arg_separator.input</parameter>

<type>string</type>

</term>

<listitem>

<para>

Список разделителей, которые PHP применяет при разборе входных URL-адресов на переменные.

</para>

<note>

<para>

Каждый символ в директиве интерпретируется как разделитель!

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.variables-order">

<term>

<parameter>variables_order</parameter>

<type>string</type>

</term>

<listitem>

<para>

Устанавливает порядок обработки переменных EGPCS

(<literal>E</literal>nvironment,

<literal>G</literal>et, <literal>P</literal>ost,

<literal>C</literal>ookie, и <literal>S</literal>erver).

Например, если variables_order установлена в <literal>"SP"</literal>,

то PHP создаст &link.superglobals; <varname>$_SERVER</varname> и

<varname>$_POST</varname>, но не будет создавать

<varname>$_ENV</varname>, <varname>$_GET</varname> и

<varname>$_COOKIE</varname>. Установка в "" означает, что ни

одна &link.superglobals; не будет установлена.

</para>

<warning>

<para>

В CGI и FastCGI SAPI,

в <varname>$_SERVER</varname> также добавляются значения

переменных окружения; <literal>S</literal>

всегда эквивалентна <literal>ES</literal> вне зависимости от

самого положения <literal>E</literal> в этой директиве.

</para>

</warning>

<note>

<para>

Эта директива также влияет на содержимое и порядок переменной

<varname>$_REQUEST</varname>.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.request-order">

<term>

<parameter>request_order</parameter>

<type>string</type>

</term>

<listitem>

<para>

Эта директива регулирует порядок, в котором PHP добавляет переменные GET, POST

и Cookie в массив _REQUEST. Добавление производится слева направо,

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

</para>

<para>

Если значение этой директивы не установлено, то используется значение директивы <link

linkend="ini.variables-order">variables_order</link> для содержимого

переменной <varname>$_REQUEST</varname>.

</para>

<para>

Учтите, что файлы <filename>php.ini</filename>, поставляемые с дистрибутивом,

по соображениям безопасности не содержат значение <literal>'C'</literal> (cookies).

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.auto-globals-jit">

<term>

<parameter>auto_globals_jit</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Когда включено, переменные SERVER, REQUEST и ENV создаются в тот момент, когда они

впервые используются (Just In Time), а не в начале выполнения скрипта. Если эти

переменные в скрипте не используются, включение этой директивы приведёт к росту

производительности.

</para>

<warning>

<para>

Использование переменных SERVER, REQUEST и ENV проверяется на стадии компиляции,

поэтому их использование с помощью, например, <link

linkend="language.variables.variable">переменных переменных</link> не

запустит их инициализацию.

</para>

</warning>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.register-argc-argv">

<term>

<parameter>register_argc_argv</parameter>

<type>bool</type>

</term>

<listitem>

<simpara>

Сообщает PHP, объявлять ли переменные argv и argc,

которые заполняются GET-информацией.

</simpara>

<simpara>

Смотрите также раздел «<link linkend="features.commandline">Работа с PHP из командной строки</link>».

</simpara>

&warn.deprecated.feature-8-5-0;

<note>

<simpara>

Поведение, при котором PHP заполняет элементы <code>$_SERVER['argc']</code> и <code>$_SERVER['argv']</code>

из аргументов через серверный SAPI, а не в режиме CLI, устарело.

Для доступа к информации лучше установить директиву <literal>register_argc_argv=0</literal> и переключиться на считывание

аргументов либо из суперглобального массива <varname>$_GET</varname>, либо из элемента <code>$_SERVER['QUERY_STRING']</code>,

но предварительно проверить безопасность перехода с аргументов на суперглобальные переменные.

</simpara>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.enable-post-data-reading">

<term>

<parameter>enable_post_data_reading</parameter>

<type>bool</type>

</term>

<listitem>

<simpara>

При отключении опции суперглобальные массивы <varname>$_POST</varname>

и <varname>$_FILES</varname> <emphasis>не заполняются</emphasis>.

Сырое тело запроса остаётся в потоке <link linkend="wrappers.php">php://input</link>,

откуда данные считывают вручную или разбирают функцией <function>request_parse_body</function>.

Отключение опции полезно для проксирования запросов или обработки POST-данных

с минимумом нагрузки на память.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.post-max-size">

<term>

<parameter>post_max_size</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

Устанавливает максимально допустимый размер данных, отправляемых методом POST.

Это значение также влияет на загрузку файлов. Для загрузки больших файлов это

значение должно быть больше значения директивы

<link linkend="ini.upload-max-filesize">upload_max_filesize</link>.

</simpara>

<simpara>

В сущности,

<link linkend="ini.memory-limit">memory_limit</link> должна быть

больше чем <parameter>post_max_size</parameter>.

</simpara>

&ini.shorthandbytes;

<simpara>

Если размер POST-данных больше значения директивы post_max_size,

<link linkend="language.variables.superglobals">суперглобальные переменные</link>

<varname>$_POST</varname> и <varname>$_FILES</varname>

будут пустыми. Это проверяют разными способами, например,

передав переменную <varname>$_GET</varname> в скрипт, который обрабатывает

данные, т. е. <literal>&lt;form action="edit.php?processed=1"&gt;</literal>,

а затем проверить, установлена ли переменная <varname>$_GET['processed']</varname>.

</simpara>

<para>

<note>

<para>

PHP разрешает сокращения значений байтов, включая K (кило), M (мега) и G (гига).

PHP автоматически преобразовывает эти сокращения. Будьте осторожны с превышением

диапазона 32-битных целых значений на 32-битной версии PHP, поскольку

это приведёт к ошибке скрипта.

</para>

</note>

</para>

<para>

<table>

<title>Список изменений <literal>post_max_size</literal></title>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>5.3.4</entry>

<entry>

Установка <parameter>post_max_size</parameter> = 0 не снимет ограничение, если

контент имеет тип application/x-www-form-urlencoded или не зарегистрирован в PHP.

</entry>

</row>

<row>

<entry>5.3.2 , 5.2.12</entry>

<entry>

Стало возможным снять ограничение на размер пост-запроса установкой

<parameter>post_max_size</parameter> в 0.

</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.auto-prepend-file">

<term>

<parameter>auto_prepend_file</parameter>

<type>string</type>

</term>

<listitem>

<para>

Определяет имя файла, который будет автоматически обрабатываться

перед основным файлом. Файл вызывается так, будто он был подключён

при помощи функции <function>require</function>, так что

<link linkend="ini.include-path">include_path</link> также используется.

</para>

<para>

Специальное значение <literal>none</literal> отключает эту директиву.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.auto-append-file">

<term>

<parameter>auto_append_file</parameter>

<type>string</type>

</term>

<listitem>

<para>

Определяет имя файла, который будет автоматически обрабатываться

после основного файла. Файл вызывается так, будто он был подключён

при помощи функции <function>require</function>, так что

<link linkend="ini.include-path">include_path</link> тоже используется.

</para>

<para>

Специальное значение <literal>none</literal> отключает эту директиву.

<note>

<simpara>

Если скрипт завершает работу при помощи <function>exit</function>,

auto-append <emphasis>НЕ</emphasis> выполняется.</simpara>

</note>

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.default-mimetype">

<term>

<parameter>default_mimetype</parameter>

<type>string</type>

</term>

<listitem>

<para>

По умолчанию PHP выводит название кодировки в заголовке Content-Type. Если

передавать кодировку не требуется, просто оставьте эту опцию пустой.

</para>

<para>

"media type" по умолчанию установлен как "text/html".

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.default-charset">

<term>

<parameter>default_charset</parameter>

<type>string</type>

</term>

<listitem>

<para>

"UTF-8" — значение по умолчанию и используется как

кодировка по умолчанию для функций

<function>htmlentities</function>,

<function>html_entity_decode</function>

и <function>htmlspecialchars</function>, если параметр

<parameter>encoding</parameter> не указали. Значение

<parameter>default_charset</parameter> также используется для указания

кодировки по умолчанию для функций <link linkend="book.iconv">iconv</link>, если

конфигурационные опции <link linkend="ini.iconv.input-encoding">

<parameter>iconv.input_encoding</parameter></link>, <link

linkend="ini.iconv.output-encoding"><parameter>iconv.output_encoding</parameter>

</link> и <link linkend="ini.iconv.internal-encoding"><parameter>

iconv.internal_encoding</parameter></link> не установлены, и для функций

<link linkend="book.mbstring">mbstring</link>, если не установлены

<link linkend="ini.mbstring.http-input"><parameter>mbstring.http_input</parameter></link>

<link linkend="ini.mbstring.http-output"><parameter>mbstring.http_output</parameter></link>

<link linkend="ini.mbstring.internal-encoding"><parameter>mbstring.internal_encoding</parameter></link>.

</para>

<para>

Все версии PHP используют это значение как кодировку для

стандартного заголовка Content-Type, отправляемого PHP, если

этот заголовок не переопределён вызовом функции <function>header</function>.

</para>

<para>

Не рекомендуется устанавливать <parameter>default_charset</parameter>

в пустое значение.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.input-encoding">

<term>

<parameter>input_encoding</parameter>

<type>string</type>

</term>

<listitem>

<para>

Эта опция используется для многобайтных модулей,

таких как mbstring и iconv. По умолчанию пусто.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.output-encoding">

<term>

<parameter>output_encoding</parameter>

<type>string</type>

</term>

<listitem>

<para>