php/archived-doc-fr
1
0
Fork 0
mirror of https://github.com/php/doc-fr.git synced 2026-03-23 22:52:18 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
master
archived-doc-fr/reference/mbstring/ini.xml
Louis-Arnaud df96969fec Style impersonnel dans reference/ (j-o) (#2537)
2026-02-25 09:45:51 +01:00

426 lines
13 KiB
XML
Raw Permalink Blame History

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 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. À noter 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'encodage 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. Se reporter à 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 peut 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
-->
Reference in New Issue View Git Blame Copy Permalink