archived-doc-ru/reference/mbstring/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: af844f698b38d1460464bf913a80f2397980c534 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<section xml:id="mbstring.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>Опции конфигурации mbstring</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody xml:id="mbstring.configuration.list">
     <row>
      <entry><link linkend="ini.mbstring.language">mbstring.language</link></entry>
      <entry>"neutral"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mbstring.detect-order">mbstring.detect_order</link></entry>
      <entry>NULL</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mbstring.http-input">mbstring.http_input</link></entry>
      <entry>"pass"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry>Устарела</entry>
     </row>
     <row>
      <entry><link linkend="ini.mbstring.http-output">mbstring.http_output</link></entry>
      <entry>"pass"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry>Устарела</entry>
     </row>
     <row>
      <entry><link linkend="ini.mbstring.internal-encoding">mbstring.internal_encoding</link></entry>
      <entry>NULL</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry>Устарела</entry>
     </row>
     <row>
      <entry><link linkend="ini.mbstring.substitute-character">mbstring.substitute_character</link></entry>
      <entry>NULL</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mbstring.func-overload">mbstring.func_overload</link></entry>
      <entry>"0"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>
       Объявлено устаревшим в PHP 7.2.0; удалено с PHP 8.0.0.
      </entry>
     </row>
     <row>
      <entry><link linkend="ini.mbstring.encoding-translation">mbstring.encoding_translation</link></entry>
      <entry>"0"</entry>
      <entry><constant>INI_PERDIR</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mbstring.http-output-conv-mimetypes">mbstring.http_output_conv_mimetypes</link></entry>
      <entry>"^(text/|application/xhtml\+xml)"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mbstring.strict-detection">mbstring.strict_detection</link></entry>
      <entry>"0"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mbstring.regex-retry-limit">mbstring.regex_retry_limit</link></entry>
      <entry>"1000000"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry>Доступно, начиная с PHP 7.4.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.mbstring.regex-stack-limit">mbstring.regex_stack_limit</link></entry>
      <entry>"100000"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry>Доступно, начиная с PHP 7.3.5.</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
 </para>

 &ini.descriptions.title;

 <para>
  <variablelist>
   <varlistentry xml:id="ini.mbstring.language">
    <term>
     <parameter>mbstring.language</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      По умолчанию в mbstring используются настройки национального языка.
      Обратите внимание, что эта опция автоматически определяет <literal>mbstring.internal_encoding</literal>, и
      <literal>mbstring.internal_encoding</literal> должен быть помещён после
      <literal>mbstring.language</literal> в &php.ini;
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.encoding-translation">
    <term>
     <parameter>mbstring.encoding_translation</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Включает прозрачный фильтр кодировки для входящих запросов HTTP,
      который выполняет обнаружение и преобразование входной кодировки
      во внутреннюю кодировку.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.internal-encoding">
    <term>
     <parameter>mbstring.internal_encoding</parameter>
     <type>string</type>
    </term>
    <listitem>
     <warning>
      <para>&removed.php.future;</para>
     </warning>
     <para>
      Определяет внутреннюю кодировку символов по умолчанию.
     </para>
     <para>
      Пользователи должны оставить эту опцию пустой и задать вместо неё
      <link linkend="ini.default-charset"><parameter>default_charset</parameter></link>.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.http-input">
    <term>
     <parameter>mbstring.http_input</parameter>
     <type>string</type>
    </term>
    <listitem>
     <warning>
      <para>&removed.php.future;</para>
     </warning>
     <para>
      Определяет кодировку символов по умолчанию для HTTP-ввода.
     </para>
     <para>
      Пользователи должны оставить эту опцию пустой и задать вместо неё
      <link linkend="ini.default-charset"><parameter>default_charset</parameter></link>.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.http-output">
    <term>
     <parameter>mbstring.http_output</parameter>
     <type>string</type>
    </term>
    <listitem>
     <warning>
      <para>&removed.php.future;</para>
     </warning>
     <para>
      Определяет кодировку символов по умолчанию для HTTP-вывода
      (конвертация из внутренней кодировки в кодировку HTTP вывода произойдёт перед выводом).
     </para>
     <para>
      Пользователи должны оставить эту опцию пустой и задать вместо неё
      <link linkend="ini.default-charset"><parameter>default_charset</parameter></link>.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.detect-order">
    <term>
     <parameter>mbstring.detect_order</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Определяет порядок определения кодировки символов по умолчанию. Смотрите также
      <function>mb_detect_order</function>.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.substitute-character">
    <term>
     <parameter>mbstring.substitute_character</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Определяет символ для замены недопустимых символов кодировки.
      Список поддерживаемых значений смотрите в описании функции <function>mb_substitute_character</function>.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.func-overload">
    <term>
     <parameter>mbstring.func_overload</parameter>
     <type>string</type>
    </term>
    <listitem>
     &warn.deprecated.feature-7-2-0.removed-8-0-0;
     <para>
      Перегружает множество однобайтовых функций аналогами из mbstring. Смотрите
      раздел <link linkend="mbstring.overload">Перегрузка функций</link> для
      получения дополнительной информации.
     </para>
     <para>
      Эта опция может быть изменена только в файле &php.ini;.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.http-output-conv-mimetypes">
    <term>
     <parameter>mbstring.http_output_conv_mimetypes</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.strict-detection">
    <term>
     <parameter>mbstring.strict_detection</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Включает строгое определение кодировки. Смотрите
      описание и примеры в <function>mb_detect_encoding</function>.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.regex-retry-limit">
    <term>
     <parameter>mbstring.regex_retry_limit</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Ограничивает количество обратных ходов, которые могут быть выполнены во время одного совпадения mbregex.
     </para>
     <para>
      Эта настройка действует только при связывании с oniguruma >= 6.8.0.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.regex-stack-limit">
    <term>
     <parameter>mbstring.regex_stack_limit</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Ограничивает глубину стека регулярных выражений mbstring.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>

 <para>
  Согласно <link xlink:href="&url.spec.html401.accept-charset;">спецификации HTML 4.01</link>,
  веб-браузерам разрешено перекодировать данные из формы, которые они получают в
  кодировке символов, отличной от используемой на странице.
  Смотрите функцию <function>mb_http_input</function> для того, чтобы определить
  кодировку символов, используемую браузерами.
 </para>
 <para>
  Хотя популярные браузеры способны достаточно точно определить
  кодировку символов данного HTML-документа, было бы лучше
  установить параметр <literal>charset</literal> в HTTP-заголовке
  <literal>Content-Type</literal>
  соответствующим значением с помощью <function>header</function> или указать требуемое значение в параметре
  <link linkend="ini.sect.data-handling">default_charset</link> в ini-настройках.
 </para>
 <para>
  <example>
   <title>Примеры настроек &php.ini;</title>
   <programlisting>
<![CDATA[
; Установить язык по умолчанию
mbstring.language        = Neutral; Установить Neutral(UTF-8) языком по умолчанию (по умолчанию)
mbstring.language        = English; Установить английский языком по умолчанию
mbstring.language        = Japanese; Установить японский языком по умолчанию

;; Установить внутреннюю кодировку по умолчанию
;; Примечание: Убедитесь, что используете кодировку символов, которая работает с PHP
mbstring.internal_encoding    = UTF-8  ; Установить внутреннюю кодировку в UTF-8

;; Включено преобразование кодировки HTTP-ввода.
mbstring.encoding_translation = On

;; Установить кодировку символов по умолчанию для HTTP-ввода
;; Примечание: Скрипт не может изменить установку http_input.
mbstring.http_input           = pass    ; Нет преобразования.
mbstring.http_input           = auto    ; Установить HTTP-ввод в auto
                                ; "auto" расширяется в соответствии с mbstring.language
mbstring.http_input           = SJIS    ; Установить HTTP-ввод в SJIS
mbstring.http_input           = UTF-8,SJIS,EUC-JP ; Указать порядок

;; Установить кодировку символов по умолчанию для HTTP-вывода
mbstring.http_output          = pass    ; Нет преобразования.
mbstring.http_output          = UTF-8   ; Установить кодировку HTTP-вывода в UTF-8

;; Установить порядок определения кодировки символов по умолчанию
mbstring.detect_order         = auto    ; Установить порядок определения в auto
mbstring.detect_order         = ASCII,JIS,UTF-8,SJIS,EUC-JP ; Указать порядок

;; Установить символ замены по умолчанию
mbstring.substitute_character = 12307   ; Указать значение Unicode
mbstring.substitute_character = none    ; Не печатать символ
mbstring.substitute_character = long    ; Примеры кодовых значений символов: U+3000,JIS+7E7E
]]>
   </programlisting>
  </example>
 </para>
 <para>
  <example>
   <title>Настройки &php.ini; для пользователей <literal>EUC-JP</literal></title>
   <programlisting>
<![CDATA[
;; Отключить буферизацию вывода
output_buffering      = Off

;; Установить кодировку в http-заголовке
default_charset       = EUC-JP

;; Установить японский языком по умолчанию
mbstring.language = Japanese

;; Включено преобразование кодировки HTTP-ввода.
mbstring.encoding_translation = On

;; Установить перекодировку HTTP-ввода в auto
mbstring.http_input   = auto

;; Конвертировать HTTP-вывод в EUC-JP
mbstring.http_output  = EUC-JP

;; Установить внутреннюю кодировку в EUC-JP
mbstring.internal_encoding = EUC-JP

;; Не печатать недопустимые символы
mbstring.substitute_character = none
]]>
   </programlisting>
  </example>
 </para>
 <para>
  <example>
   <title>Настройки &php.ini; для пользователей <literal>SJIS</literal></title>
   <programlisting>
<![CDATA[
;; Включить буферизацию вывода
output_buffering     = On

;; Установить mb_output_handler для включения перекодировки вывода
output_handler       = mb_output_handler

;; Установить кодировку в http-заголовке
default_charset      = Shift_JIS

;; Установить японский языком по умолчанию
mbstring.language = Japanese

;; Установить перекодировку HTTP-ввода в auto
mbstring.http_input  = auto

;; Конвертировать в SJIS
mbstring.http_output = SJIS

;; Установить внутреннюю кодировку в EUC-JP
mbstring.internal_encoding = EUC-JP

;; Не печатать недопустимые символы
mbstring.substitute_character = none
]]>
   </programlisting>
  </example>
 </para>

</section><!-- 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
-->