doc-fr/reference/mbstring/ini.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.16 $ -->
<!-- EN-Revision: 1.15 Maintainer: dams Status: ready -->
<!-- Reviewed: yes -->
<section id="mbstring.configuration">
 &reftitle.runtime;
 &extension.runtime;
 <para>
   <table>
    &ini.table.title;
   <tgroup cols="4">
    <thead>
     &ini.table.top;
    </thead>
   <tbody>
    <row>
     <entry>mbstring.language</entry>
     <entry>"neutral"</entry>
     <entry>PHP_INI_PERDIR</entry>
     <entry>Disponible depuis &php; 4.3.0</entry>
    </row>
    <row>
     <entry>mbstring.detect_order</entry>
     <entry>NULL</entry>
     <entry>PHP_INI_ALL</entry>
     <entry>Disponible depuis &php; 4.0.6</entry>
    </row>
    <row>
     <entry>mbstring.http_input</entry>
     <entry>"pass"</entry>
     <entry>PHP_INI_ALL</entry>
     <entry>Disponible depuis &php; 4.0.6</entry>
    </row>
    <row>
     <entry>mbstring.http_output</entry>
     <entry>"pass"</entry>
     <entry>PHP_INI_ALL</entry>
     <entry>Disponible depuis &php; 4.0.6</entry>
    </row>
    <row>
     <entry>mbstring.internal_encoding</entry>
     <entry>NULL</entry>
     <entry>PHP_INI_ALL</entry>
     <entry>Disponible depuis &php; 4.0.6</entry>
    </row>
    <row>
     <entry>mbstring.script_encoding</entry>
     <entry>NULL</entry>
     <entry>PHP_INI_ALL</entry>
     <entry>Disponible depuis &php; 4.3.0</entry>
    </row>
    <row>
     <entry>mbstring.substitute_character</entry>
     <entry>NULL</entry>
     <entry>PHP_INI_ALL</entry>
     <entry>Disponible depuis &php; 4.0.6</entry>
    </row>
    <row>
     <entry>mbstring.func_overload</entry>
     <entry>"0"</entry>
     <entry>PHP_INI_PERDIR</entry>
     <entry>PHP_INI_SYSTEM en &php; &lt;= 4.2.3. Disponible depuis &php; 4.2.0</entry>
    </row>
    <row>
     <entry>mbstring.encoding_translation</entry>
     <entry>"0"</entry>
     <entry>PHP_INI_PERDIR</entry>
     <entry>Disponible depuis &php; 4.3.0</entry>
    </row>
   </tbody>
  </tgroup>
 </table>
 &ini.php.constants;
 </para>
 &ini.descriptions.title;

 <para>
  <variablelist>
   <varlistentry 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 id="ini.mbstring.encoding-translation">
    <term>
     <parameter>mbstring.encoding_translation</parameter>
     <type>boolean</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 id="ini.mbstring.internal-encoding">
    <term>
     <parameter>mbstring.internal_encoding</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Définit l'encodage interne par défaut.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry id="ini.mbstring.http-input">
    <term>
     <parameter>mbstring.http_input</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Définit l'encodage de réception HTTP par défaut.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry id="ini.mbstring.http-output">
    <term>
     <parameter>mbstring.http_output</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Définit l'encodage d'affichage HTTP par défaut.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry 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 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.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry id="ini.mbstring.func-overload">
    <term>
     <parameter>mbstring.func_overload</parameter>
     <type>string</type>
    </term>
    <listitem>
     <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>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>

 <para>
  En accord avec <ulink url="http://www.w3.org/TR/REC-html40/interact/forms.html#adef-accept-charset">HTML 4.01 specification</ulink>,
  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. Si <literal>charset</literal> est
  activé dans les en-têtes, cela donnera de meilleurs résultats. Changez la valeur
  de <link linkend="ini.sect.data-handling">default_charset</link> avec la valeur 
  appropriée dans le fichier ini.
 </para>
 <para>
  <example>
  <title>Configuration de &php.ini; pour mbstring</title>
   <programlisting>
<![CDATA[
; Langage par défaut
mbstring.language        = Neutral; (UTF-8) (par défault)
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é par "ASCII,JIS,UTF-8,EUC-JP,SJIS"
mbstring.http_input           = SJIS    ; Utilise SJIS
mbstring.http_input           = UTF-8,SJIS,EUC-JP ; Specifie 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

;; Acitvation de la converstion 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:"../../../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
-->