ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: af844f698b38d1460464bf913a80f2397980c534 Maintainer: yannick 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>&ConfigureOptions; 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>Obsolète</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>Obsolète</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>Obsolète</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>
       Obsolète à partir de PHP 7.2.0; supprimée à partir de 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>Disponible à partir de 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>Disponible à partir de 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>
      Définit le langage utilisé
      par mbstring. Notez que cette option définit
      <literal>mbstring.internal_encoding</literal>
      <literal>mbstring.internal_encoding</literal>
      doit être placé après <literal>mbstring.language</literal>
      dans le fichier &php.ini;
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.encoding-translation">
    <term>
     <parameter>mbstring.encoding_translation</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Active la détection et la traduction des données d'entrées HTTP vers
      le codage interne mbstring.
     </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>
      Définit l'encodage interne par défaut.
     </para>
     <para>
      Les utilisateurs devraient laisser cette option vide et définir plutôt l'option
      <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>
      Définit l'encodage de réception HTTP par défaut.
     </para>
     <para>
      Les utilisateurs devraient laisser cette option vide et définir plutôt l'option
      <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>
      Définit l'encodage d'affichage HTTP par défaut (l'affichage sera
      converti depuis l'encodage interne vers l'encode HTTP de la
      sortie, lors de l'affichage).
     </para>
     <para>
      Les utilisateurs devraient laisser vide cette option et définir plutôt l'option
      <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>
      Définit l'ordre de détection des encodages par défaut. Voir aussi
      <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>
      Définit l'encodage de substitution par défaut :
      il est utilisé pour les caractères invalides.
      Voir <function>mb_substitute_character</function> pour les valeurs supportées.
     </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>
      Remplace les fonctions de traitement des chaînes par les fonctions mbstring.
      Voir les <link linkend="mbstring.overload">fonctions de remplacement</link> 
      pour plus d'informations.
     </para>
     <para>
      Ce paramètre ne peut être changé que depuis le fichier &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>
      Active la détection stricte de l'encodage.
      Voir <function>mb_detect_encoding</function>
      pour une description et des exemples.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mbstring.regex-retry-limit">
    <term>
     <parameter>mbstring.regex_retry_limit</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Limite la quantité de retour en arrière qui peut être effectuée pendant une correspondance mbregex.
     </para>
     <para>
      Ce paramètre ne prend effet que lors de la liaison avec 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>
      Limite la profondeur de la pile des expressions régulières mbstring.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>

 <para>
  En accord avec <link xlink:href="&url.spec.html401.accept-charset;">HTML 4.01 specification</link>,
  les navigateurs sont supposés utiliser le même jeu de caractères
  lorsqu'ils soumettent un formulaire. Mais, tous les navigateurs
  ne le font pas. Reportez-vous à la fonction <function>mb_http_input</function>
  pour détecter les jeux de caractères utilisés par les navigateurs.
 </para>

 <para>
  En général, les navigateurs sont suffisamment intelligents pour détecter
  les jeux de caractères dans le HTML. Néanmoins, il convient de définir
  le paramètre <literal>charset</literal> de l'en-tête HTTP
  <literal>Content-Type</literal> à la valeur fournie par la fonction
  <function>header</function> ou par l'option de configuration
  <link linkend="ini.sect.data-handling">default_charset</link>.
 </para>
 <para>
  <example>
  <title>Configuration de &php.ini; pour mbstring</title>
   <programlisting>
<![CDATA[
; Langage par défaut
mbstring.language        = Neutral; (UTF-8) (par défaut)
mbstring.language        = English; Anglais
mbstring.language        = Japanese; Japonais

;; Jeu de caractère interne
;; Note : assurez-vous que ce jeu fonctionne avec PHP
mbstring.internal_encoding    = UTF-8

;; Activation de la conversion automatique des entrées HTTP
mbstring.encoding_translation = On

;; Jeu de caractères par défaut pour les données d'entrée HTTP
;; Note : le script ne peux pas changer cette configuration
mbstring.http_input           = pass    ; Aucune conversion.
mbstring.http_input           = auto    ; Utilise auto
                                ; "auto" est remplacé suivant mbstring.language
mbstring.http_input           = SJIS    ; Utilise SJIS
mbstring.http_input           = UTF-8,SJIS,EUC-JP ; Spécifie l'ordre

;;Jeu de caractères par défaut pour les données de sortie HTTP
mbstring.http_output          = pass    ; Aucune conversion
mbstring.http_output          = UTF-8   ; Utilise UTF-8

;; Ordre de détection des jeux de caractères
mbstring.detect_order         = auto    ; Utilise la détection automatique
mbstring.detect_order         = ASCII,JIS,UTF-8,SJIS,EUC-JP ; Spécifie l'ordre

;; Déterminer le jeu de caractères de substitution par défaut
mbstring.substitute_character = 12307   ; Spécifie une valeur Unicode
mbstring.substitute_character = none    ; Ne pas afficher de caractères
mbstring.substitute_character = long    ; Exemple complet : U+3000,JIS+7E7E
]]>
   </programlisting>
  </example>
 </para>
 <para>
  <example>
   <title>Configuration de &php.ini; pour les utilisateurs de <literal>EUC-JP</literal></title>
   <programlisting>
<![CDATA[
;; Désactive la bufferisation de sortie
output_buffering      = Off

;; Choisit le jeu de caractères
default_charset       = EUC-JP

;; Le langage par défaut est le japonais
mbstring.language = Japanese

;; Activation de la traduction automatique des données d'entrée HTTP
mbstring.encoding_translation = On

;; Activation de la conversion automatique
mbstring.http_input   = auto

;; Convertit les sorties en EUC-JP
mbstring.http_output  = EUC-JP

;; Utilise le jeu de caractères interne EUC-JP
mbstring.internal_encoding = EUC-JP

;; Ne pas afficher les caractères invalides
mbstring.substitute_character = none
]]>
   </programlisting>
  </example>
 </para>
 <para>
  <example>
   <title>Configuration de &php.ini; pour les utilisateurs de <literal>SJIS</literal></title>
   <programlisting>
<![CDATA[
;; Active la bufferisation de sortie
output_buffering     = On

;; Utilise le gestionnaire mb_output_handler pour la conversion de sortie
output_handler       = mb_output_handler

;; Choisit le jeu de caractères
default_charset      = Shift_JIS

;; Le langage par défaut est le japonais
mbstring.language = Japanese

;; Activation de la traduction automatique des données d'entrée HTTP
mbstring.http_input  = auto

;; Convertit en SJIS
mbstring.http_output = SJIS

;;Utilise le jeu de caractères interne EUC-JP
mbstring.internal_encoding = EUC-JP

;; Ne pas afficher les caractères invalides
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
-->