dams Wed Nov 14 16:23:12 2001 EDT
Modified files:
/phpdoc/fr/functions mail.xml math.xml mbstring.xml ldap.xml
Log:
Gathering of minor update since July.
Index: phpdoc/fr/functions/mail.xml
diff -u phpdoc/fr/functions/mail.xml:1.11 phpdoc/fr/functions/mail.xml:1.12
--- phpdoc/fr/functions/mail.xml:1.11 Tue Jul 31 04:05:31 2001
+++ phpdoc/fr/functions/mail.xml Wed Nov 14 16:23:12 2001
@@ -1,9 +1,62 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.12 $ -->
<reference id="ref.mail">
<title>Email</title>
<titleabbrev>Mail</titleabbrev>
<partintro>
<simpara>
- <function>mail</function> envoie du courrier éléctronique.</simpara>
+ <function>mail</function> envoie du courrier éléctronique.
+ </simpara>
+ <variablelist>
+ <title>Directive de configuration du courrier éléctronique</title>
+ <varlistentry>
+ <term>
+ <parameter>SMTP</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ Nom de serveur ou adresse IP du serveur SMTP que PHP sous
+ Windows doit utiliser pour envoyer le mail avec la fonction
+ <function>mail</function>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <parameter>sendmail_from</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ Entête MIME <literal>"From:"</literal> qui doit être utilisé
+dans les
+ mail, pour PHP sous Windows.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <parameter>sendmail_path</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ Localisation du programme <command>sendmail</command>
+(généralement
+ <filename>/usr/sbin/sendmail</filename> ou
+<filename>/usr/lib/sendmail</filename>).
+ La commande <command>configure</command> effectue une recherche automatique
+ plutôt efficace pour vous, et choisit une des valeurs par défaut.
+Si cette
+ recherche échoue, vous pouvez indiquer les informations ici.
+ </para>
+ <para>
+ Les systèmes qui n'utilisentp as sendmail doivent utiliser cette
+ directive pour indiquer le programme de mail de remplacement. Par
+ exemple, pour <ulink url="&url.qmail;">Qmail</ulink>, vous pouvez
+ utiliser la valeur suivante :
+ <filename>/var/qmail/bin/sendmail</filename>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</partintro>
<refentry id="function.mail">
<refnamediv>
@@ -36,8 +89,8 @@
<parameter>to</parameter>. Les destinataires multiples doivent être
séparés par des virgules. Les emails avec pièces jointes
ou contenus particuliers (comme les emails en HTML, par exemple), peuvent
- être réalisés avec cette fonction. Il faut respecter
l'encodage MIME. Pour
- plus de détails, voyez
+ être réalisés avec cette fonction. Il faut respecter
+ l'encodage MIME. Pour plus de détails, voyez
<ulink url="&url.zend.mail;">&url.zend.mail;</ulink> et
la RFC 1896 (Visit <ulink
url="&url.rfc.editor;">http://www.rfc-editor.org/</ulink>).
</simpara>
@@ -184,7 +237,7 @@
$user = "[EMAIL PROTECTED]";
$hash = ezmlm_hash($user);
$query = sprintf("INSERT INTO sample VALUES (%s, '%s')", $hash, $user);
- $db->query($query);
+ $db->query($query);
// utilisation de l'interface PHPLIB
?>
</programlisting>
Index: phpdoc/fr/functions/math.xml
diff -u phpdoc/fr/functions/math.xml:1.14 phpdoc/fr/functions/math.xml:1.15
--- phpdoc/fr/functions/math.xml:1.14 Fri Aug 10 09:19:43 2001
+++ phpdoc/fr/functions/math.xml Wed Nov 14 16:23:12 2001
@@ -1,4 +1,5 @@
-<!-- $Revision: 1.14 $ -->
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.15 $ -->
<reference id="ref.math">
<title>Mathématiques</title>
<titleabbrev>Maths</titleabbrev>
@@ -6,8 +7,9 @@
<sect1 id="math.intro">
<title>Introduction</title>
<para>
- Ces fonctions ne sont capables de manipuler que des entiers "double", ou
- des "long". Si vous avez besoin de manipuler des nombres plus grands,
+ Ces fonctions ne sont capables de manipuler que des entiers
+ <type>integer</type>, ou nombres à virgule flottante (<type>float</type>).
+ Si vous avez besoin de manipuler des nombres plus grands,
reportez-vous aux fonctions mathématiques sur des
<link linkend="ref.bc">nombres de grande taille</link>.
</para>
@@ -164,6 +166,33 @@
</para>
</refsect1>
</refentry>
+ <refentry id="function.acosh">
+ <refnamediv>
+ <refname>acosh</refname>
+ <refpurpose>Arc cosinus hyperbolique</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>acosh</function></funcdef>
+ <paramdef>float <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>acosh</function> retourne l'arc cosinus hyperbolique
+ de <parameter>arg</parameter>, c'est à dire la valeur dont
+ le cosinus hyperbolique est <parameter>arg</parameter>.
+ </para>
+ ¬e.no-windows;
+ <para>
+ Voir aussi
+ <function>acos</function>,
+ <function>asin</function> et
+ <function>atan</function>.
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.asin">
<refnamediv>
<refname>Asin</refname>
@@ -188,6 +217,33 @@
</para>
</refsect1>
</refentry>
+ <refentry id="function.asinh">
+ <refnamediv>
+ <refname>asinh</refname>
+ <refpurpose>Arc sinus hyperbolique</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>asinh</function></funcdef>
+ <paramdef>float <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>asinh</function> retourne l'arc sinus
+ hyperbolique de <parameter>arg</parameter>, c'est à dire la valeur dont
+ le sinus hyperbolique est <parameter>arg</parameter>.
+ </para>
+ ¬e.no-windows;
+ <para>
+ Voir aussi
+ <function>asin</function>,
+ <function>acos</function> et
+ <function>atan</function>.
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.atan">
<refnamediv>
<refname>Atan</refname>
@@ -244,6 +300,33 @@
</para>
</refsect1>
</refentry>
+ <refentry id="function.atanh">
+ <refnamediv>
+ <refname>atanh</refname>
+ <refpurpose>Arc tangeant hyperbolique</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>atanh</function></funcdef>
+ <paramdef>float <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>atanh</function> retourne l'arc tangente hyperbolique
+ de <parameter>arg</parameter>, c'est à dire la valeur dont
+ la tangente hyperbolique est <parameter>arg</parameter>.
+ </para>
+ ¬e.no-windows;
+ <para>
+ Voir aussi
+ <function>atan</function>,
+ <function>asin</function> et
+ <function>acos</function>.
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.base-convert">
<refnamediv>
<refname>base_convert</refname>
@@ -341,7 +424,7 @@
</para>
<simpara>
NOTE: <function>ceil</function> sous PHP/FI 2 retournait un nombre à
- virgule flottante. Utilisez: <literal>$new = (double)ceil($number);</literal>
+ virgule flottante. Utilisez: <literal>$new = (float)ceil($number);</literal>
pour retrouver le comportement traditionnel.
</simpara>
<simpara>
@@ -375,6 +458,33 @@
</para>
</refsect1>
</refentry>
+ <refentry id="function.cosh">
+ <refnamediv>
+ <refname>cosh</refname>
+ <refpurpose>Cosinus hyperbolic</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>cosh</function></funcdef>
+ <paramdef>float <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>cosh</function> retourne le cosinus hyperbolique de
+ <parameter>arg</parameter>, définit comme
+ <literal>(exp(arg) + exp(-arg))/2</literal>.
+ </para>
+ <para>
+ Voir aussi
+ <function>cos</function>,
+ <function>acosh</function>,
+ <function>sin</function> et
+ <function>tan</function>.
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.decbin">
<refnamediv>
<refname>DecBin</refname>
@@ -462,8 +572,8 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>double <function>deg2rad</function></funcdef>
- <paramdef>double <parameter>number</parameter></paramdef>
+ <funcdef>float <function>deg2rad</function></funcdef>
+ <paramdef>float <parameter>number</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -522,7 +632,7 @@
</simpara>
<simpara>
NOTE: <function>floor</function> sous PHP/FI retournait un float.
- Utilisez: <literal>$new = (double)floor($number);</literal>
+ Utilisez: <literal>$new = (float)floor($number);</literal>
pour retrouver le comportement traditionnel.
</simpara>
<simpara>
@@ -615,7 +725,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>double <function>lcg_value</function></funcdef>
+ <funcdef>float <function>lcg_value</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
@@ -623,8 +733,8 @@
<function>lcg_value</function> retourne un nombre pseudo-aléatoire,
compris entre 0 et 1. <function>lcg_value</function> combine deux
générateurs de congruence, de périodes respectives
- <literal>2^31 - 85</literal> et <literal>2^31 - 249</literal>.
- La période de cette fonction est le produit de ces deux
+ <literal>2^31 - 85</literal> et <literal>2^31 - 249</literal>.
+ La période de cette fonction est le produit de ces deux
nombres premiers (soit <literal>(2^31 - 85)*(2^31 - 249)</literal>).
</para>
</refsect1>
@@ -643,7 +753,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>log</function> retourne le logarithme naturel
+ <function>log</function> retourne le logarithme naturel
(ou népérien) de <parameter>arg</parameter>.
</para>
</refsect1>
@@ -676,10 +786,10 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>mixed <function>max</function></funcdef>
- <paramdef>mixed <parameter>arg1</parameter></paramdef>
- <paramdef>mixed <parameter>arg2</parameter></paramdef>
- <paramdef>mixed <parameter>argn</parameter></paramdef>
+ <funcdef>number <function>max</function></funcdef>
+ <paramdef>number <parameter>arg1</parameter></paramdef>
+ <paramdef>number <parameter>arg2</parameter></paramdef>
+ <paramdef>number <parameter>argn</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -690,14 +800,16 @@
Si le premier paramètre est un tableau,
<function>max</function> retourne la plus grande valeur de ce tableau.
Si le premier paramètre est un entier, une chaîne ou
- un double, <function>max</function> requiert au moins deux paramètres,
+ un nombre à virgule flottante (<type>float</type>),
+ <function>max</function> requiert au moins deux paramètres,
et retournera alors le plus grand d'entre eux.
Le nombre d'arguments est alors illimité.
</para>
<para>
- Si au moins une valeur est un entier double, elles seront toutes
- traitées comme des doubles, et un double sera retourné.
- Si aucune valeur n'est de type double, elles seront traitées
+ Si au moins une valeur est un nombre à virgule flottante, elles seront
+toutes
+ traitées comme des nombres à virgule flottante, et un nombre
+ à virgule flottante sera retourné.
+ Si aucune valeur n'est un nombre à virgule flottante, elles seront
+traitées
comme des entiers, et un entier sera retourné.
</para>
</refsect1>
@@ -711,10 +823,10 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>mixed <function>min</function></funcdef>
- <paramdef>mixed <parameter>arg1</parameter></paramdef>
- <paramdef>mixed <parameter>arg2</parameter></paramdef>
- <paramdef>mixed <parameter>argn</parameter></paramdef>
+ <funcdef>number <function>min</function></funcdef>
+ <paramdef>number <parameter>arg1</parameter></paramdef>
+ <paramdef>number <parameter>arg2</parameter></paramdef>
+ <paramdef>number <parameter>argn</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -724,15 +836,16 @@
<para>
Si le premier paramètre est un tableau, <function>min</function>
retourne la plus petite valeur de ce tableau. Si le premier
- paramètre est un entier, une chaîne ou un double,
+ paramètre est un entier, une chaîne ou un nombre à virgule
+flottante,
<function>min</function> requiert au moins deux paramètres, et
retournera alors le plus petit d'entre eux. Le nombre d'arguments est alors
illimité.
</para>
<para>
- Si au moins une valeur est un entier double, elles seront toutes
- traitées comme des doubles, et un double sera retourné.
- Si aucune valeur n'est de type double, elles seront traitées
+ Si au moins une valeur est un nombre à virgule flottante, elles seront
+toutes
+ traitées comme des nombres à virgule flottante, et un nombre
+ à virgule flottante sera retourné.
+ Si aucune valeur n'est un nombre à virgule flottante, elles seront
+traitées
comme des entiers, et un entier sera retourné.
</para>
</refsect1>
@@ -749,12 +862,8 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>mt_rand</function></funcdef>
- <paramdef>int
- <parameter><optional>min</optional></parameter>
- </paramdef>
- <paramdef>int
- <parameter><optional>max</optional></parameter>
- </paramdef>
+ <paramdef>int <parameter>min</parameter></paramdef>
+ <paramdef>int <parameter>max</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
@@ -822,7 +931,7 @@
<programlisting role="php">
<?php
// initialise avec les microsecondes depuis la dernière seconde entière
- mt_srand((double)microtime()*1000000);
+ mt_srand((float) microtime()*1000000);
$randval = mt_rand();
?>
</programlisting>
@@ -974,7 +1083,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>double <function>pi</function></funcdef>
+ <funcdef>float <function>pi</function></funcdef>
<paramdef>void </paramdef>
</funcprototype>
</funcsynopsis>
@@ -1013,20 +1122,20 @@
Si possible, <function>pow</function> retourne un <type>integer</type>.
</para>
<para>
- Si le calcul ne peut être fait, une alerte sera affichée et
+ Si le calcul ne peut être fait, une alerte sera affichée et
<function>pow</function> retournera &false;.
</para>
<example>
<title>Quelques exemples avec <function>pow</function></title>
<programlisting role="php">
<?php
- var_dump( pow(2,8) );
+ var_dump( pow(2,8) );
// int(256)
- echo pow(-1,20);
+ echo pow(-1,20);
// 1
- echo pow(0, 0);
+ echo pow(0, 0);
// 1
-echo pow(-1, 5.5);
+echo pow(-1, 5.5);
// erreur
?>
</programlisting>
@@ -1034,9 +1143,9 @@
<warning>
<para>
En PHP 4.0.6 plus ancien, <function>pow</function> retournait
- toujours un nombre à virgule flottante (<type>float</type>),
- et n'affichait pas d'alerte. Si le calcul est impossible
- (racine d'un nombre négatif, par exemple),
+ toujours un nombre à virgule flottante (<type>float</type>),
+ et n'affichait pas d'alerte. Si le calcul est impossible
+ (racine d'un nombre négatif, par exemple),
<function>pow</function> retournait <literal>NAN</literal>.
</para>
</warning>
@@ -1057,8 +1166,8 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>double <function>rad2deg</function></funcdef>
- <paramdef>double <parameter>number</parameter></paramdef>
+ <funcdef>float <function>rad2deg</function></funcdef>
+ <paramdef>float <parameter>number</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -1081,12 +1190,8 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>rand</function></funcdef>
- <paramdef>int
- <parameter><optional>min</optional></parameter>
- </paramdef>
- <paramdef>int
- <parameter><optional>max</optional></parameter>
- </paramdef>
+ <paramdef>int <parameter>min</parameter></paramdef>
+ <paramdef>int <parameter>max</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
@@ -1128,8 +1233,8 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>double <function>round</function></funcdef>
- <paramdef>double <parameter>val</parameter></paramdef>
+ <funcdef>float <function>round</function></funcdef>
+ <paramdef>float <parameter>val</parameter></paramdef>
<paramdef>int
<parameter><optional>precision</optional></parameter>
</paramdef>
@@ -1139,6 +1244,19 @@
<function>round</function> retourne la valeur arrondie de
<parameter>val</parameter>
à la précision <parameter>precision</parameter>
(nombre de chiffres après la virgule).
+ Le paramètre <parameter>precision</parameter> peut être
+négatif
+ ou null (sa valeur par défaut).
+ </para>
+ <para>
+ <caution>
+ <simpara>
+ PHP ne gère par correctement les chaînes telles que <literal>"12
+300,2"</literal>,
+ par défaut. Reportez-vous à
+ <link linkend="language.types.string.conversion">la conversion de
+chaînes</link>.
+ </simpara>
+ </caution>
+ </para>
+ <para>
<informalexample>
<programlisting role="php">
<?php
@@ -1186,6 +1304,33 @@
</para>
</refsect1>
</refentry>
+ <refentry id="function.sinh">
+ <refnamediv>
+ <refname>sinh</refname>
+ <refpurpose>Sinyus hyperbolique</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>sinh</function></funcdef>
+ <paramdef>float <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>sinh</function> retourne le sinus hyperbolique
+ de <parameter>arg</parameter>, défini comme
+ <literal>(exp(arg) - exp(-arg))/2</literal>.
+ </para>
+ <para>
+ Voir aussi
+ <function>sin</function>,
+ <function>asinh</function>,
+ <function>cos</function> et
+ <function>tan</function>.
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.sqrt">
<refnamediv>
<refname>Sqrt</refname>
@@ -1225,7 +1370,7 @@
<programlisting role="php">
<?php
// initialise avec les microsecondes depuis la dernière seconde entière
- srand((double)microtime()*1000000);
+ srand((float) microtime()*1000000);
$randval = rand();
?>
</programlisting>
@@ -1260,6 +1405,33 @@
</para>
<para>
Voir aussi
+ <function>sin</function> et
+ <function>cos</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.tanh">
+ <refnamediv>
+ <refname>tanh</refname>
+ <refpurpose>Tangente hyperbolique</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>tanh</function></funcdef>
+ <paramdef>float <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>tanh</function> retourne la tangeante hyperbolique de
+ <parameter>arg</parameter>, définie comme
+ <literal>sinh(arg)/cosh(arg)</literal>.
+ </para>
+ <para>
+ Voir aussi
+ <function>tan</function>,
+ <function>atanh</function>,
<function>sin</function> et
<function>cos</function>.
</para>
Index: phpdoc/fr/functions/mbstring.xml
diff -u phpdoc/fr/functions/mbstring.xml:1.3 phpdoc/fr/functions/mbstring.xml:1.4
--- phpdoc/fr/functions/mbstring.xml:1.3 Sun Jul 8 09:01:24 2001
+++ phpdoc/fr/functions/mbstring.xml Wed Nov 14 16:23:12 2001
@@ -1,3 +1,5 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.4 $ -->
<reference id="ref.mbstring">
<title>Chaînes de caractères multi-octets</title>
<titleabbrev>Chaînes de caractères multi-octets</titleabbrev>
@@ -23,15 +25,419 @@
<para>
Les jeux de caractères multi-octets représentent les
caractères
sur plusieurs octets consécutifs (d'où leur nom). Certains
- systèmes d'encodages ont des caractères d'échappement
dédiés, pour
- démarrer/finir une séquence de caractères multi-octets. De ce
fait,
- certains caractères peuvent être détruit lorsqu'une
chaîne est
+ systèmes d'encodages ont des caractères d'échappement
+ dédiés, pour démarrer/finir une séquence de
+ caractères multi-octets. De ce fait, certains caractères
+ peuvent être détruit lorsqu'une chaîne est
coupée en plusieurs morceaux, ou bien conduire à des résultats
erronnés lorsque le nombre de caractère est compté. Il faut
utiliser
des fonctions qui supportent ces encodages. Les fonctions
<literal>mbstring</literal> supportent les jeux de caractères
multi-octets, ainsi que les conversions.
</para>
+ <para>
+ Etant donné que PHP supporte essentiellement le jeu de
+ caractères ISO-8859-1, certains jeux de caractères
+ ne fonctionnent pas bien avec PHP. Par conséquent,
+ il est important de donner une valeur à l'option de configuration
+ <literal>mbstring.internal_encoding</literal> qui permettent à PHP de
+ travailler correctement.
+ </para>
+ <para>
+ Pré-requis PHP 4
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ Encodage par octet
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Les caractères d'un octet dans l'intervalle <literal>00h-7fh</literal>
+ doivent être compatibles avec le code <literal>ASCII</literal>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Jeux de caractères multi-octets, qui n'utilisent pas l'intervalle
+ <literal>00h-7fh</literal>.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ Voici des exemples d'encodage internes :
+ <informalexample>
+ <programlisting>
+Jeu de caractères qui fonctionnent avec PHP :
+ISO-8859-*, EUC-JP, UTF-8
+Jeu de caractères qui NE fonctionnent PAS avec PHP :
+JIS, SJIS
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ Les jeux de caractères qui ne fonctionnent pas comme encodage interne
+ à PHP, peuvent toutefois être utilisé avec les fonctions de
+conversion
+ de <literal>mbstring</literal>.
+ </para>
+ <note>
+ <para>
+ SJIS ne doit pas être utilisé comme encodage interne, à
+ moins que vous ne soyez familier de l'analyseur/compilateur, et des
+ problèmes liés aux jeux de caractères.
+ </para>
+ </note>
+ <note>
+ <para>
+ SI vous utilisez une base de données avec PHP, il est recommandé
+ que vous utilisiez le même jeu de caractère pour la base de
+données
+ et le jeu de caractère interne de PHP, pour améliorer les
+performances.
+ </para>
+ <para>
+ Si vous utilisez PostgreSQL, il supporte des jeux de caractères qui
+ peuvent être différents de ceux du client. Reportez vous au manuel
+ de PostgreSQL pour plus de détails.
+ </para>
+ </note>
+ <sect2 id="mb-enable">
+ <title>Comment activer mbstring</title>
+ <para>
+ <literal>mbstring</literal> est un module PHP. Vous devez activer le
+ module avec le script de configuration <literal>configure</literal>.
+ Reportez vous à la section <link
+linkend="installation">installation</link>
+ pour plus de détails.
+ </para>
+ <simpara>
+ Les options de configurations suivantes sont liées au module
+ <literal>mbstring</literal>.
+ </simpara>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <option role="configure">--enable-mbstring</option> : Active les
+ fonctions <literal>mbstring</literal>. Cette option est nécessaire
+ pour utiliser les fonctions <literal>mbstring</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <option role="configure">--enable-mbstr-enc-trans</option> :
+ Active la conversion automatique des données par HTTP, avec le moteur
+ de conversion de <literal>mbstring</literal>. Si cette option est
+activée,
+ les données venants du web via HTTP seront converties dans le jeu
+ de caractères <literal>mbstring.internal_encoding</literal>,
+automatiquement.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </sect2>
+ <sect2 id="mb-conv">
+ <title>Entrées/Sorties HTTP</title>
+ <para>
+ La conversion automatiques des entrées/sorties HTTP peuvent
+ aussi convertir des données binaires. Les utilisateurs
+ doivent contrôler les conversions, si des données binaires doivent
+ être utilisées via HTTP.
+ </para>
+ <para>
+ Si l'option <literal>enctype</literal> d'un formulaire HTML vaut
+ <literal>multipart/form-data</literal>,
+ <literal>mbstring</literal> ne convertira pas les données du POST. Dans
+ce
+ cas, les chaînes de caractères doivent être convertis
+manuellement.
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ Entrée HTTP
+ </simpara>
+ <para>
+ Il n'y a pas de moyen de contrôler la conversion des caractères
+ HTTP en entrée, depuis un script PHP. Pour désactiver cette
+conversion,
+ il faut le faire dès le fichier <filename>php.ini</filename>.
+ <example>
+ <title>
+ Inactive la conversion HTTP dans le php.ini
+ </title>
+ <programlisting role="php">
+;; Inactive la conversion HTTP
+mbstring.http_input = pass
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Lorsque vous utilisez PHP comme module Apache, il est possible
+ d'annuler la configuration du <filename>php.ini</filename> pour
+ chaque Virtual Host dans le fichier
+ <filename>httpd.conf</filename> ou par dossier avec le fichier
+ <literal>.htaccess</literal>. Reportez vous à la section de
+ <link linkend="configuration">configuration</link> ainsi qu'au
+ manuel Apache.
+ </para>
+ </listitem>
+ <listitem>
+ <simpara>
+ Sorties HTTP
+ </simpara>
+ <para>
+ Il y a plusieurs moyens d'activer la conversion en sortie de script
+ PHP. L'un d'entre eux utilise <filename>php.ini</filename>, un autre
+ utilise <function>ob_start</function> avec la fonction
+ <function>mb_output_handler</function> comme fonction de call-back.
+ </para>
+ <note>
+ <para>
+ Pour les utilisateurs PHP3-i18n, le système de conversion de
+ <literal>mbstring</literal> diffère de celui de PHP3-i18n.
+ Le jeu de caractère est converti avec un buffer de sortie.
+ </para>
+ </note>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ <example>
+ <title>Exemple de configuration de mbstring dans
+<filename>php.ini</filename></title>
+ <programlisting role="php">
+;; Active la conversion de sortie pour toute les pages PHP
+;; Active la bufferisation de sortie
+output_buffering = On
+;; Choisi mb_output_handler pour effectuer la conversion de sortie
+output_handler = mb_output_handler
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Script example</title>
+ <programlisting role="php">
+<?php
+// Active la conversion de caractère uniquement pour cette page
+// Choisi le jeu de caractères SJIS
+mb_http_output('SJIS');
+// Commence la bufferisation et spécifie "mb_output_handler"
+// comme fonction de callback
+ob_start('mb_output_handler');
+?>
+ </programlisting>
+ </example>
+ </para>
+ </sect2>
+ <sect2 id="mb-code">
+ <title>Jeux de caractères supportés</title>
+ <simpara>
+ Actuellement, les jeux de caractères suivants sont
+ supportés par <literal>mbstring</literal>. L'encodage
+ de caractère peut être spécifié
+ par les paramètres <literal>encoding</literal> dans les fonctions
+ <literal>mbstring</literal>.
+ </simpara>
+ <para>
+ Les jeux de caractères suivants sont supportés par
+ <literal>mbstring</literal> :
+ </para>
+ <para>
+ <literal>UCS-4</literal>,
+ <literal>UCS-4BE</literal>,
+ <literal>UCS-4LE</literal>,
+ <literal>UCS-2</literal>,
+ <literal>UCS-2BE</literal>,
+ <literal>UCS-2LE</literal>,
+ <literal>UTF-32</literal>,
+ <literal>UTF-32BE</literal>,
+ <literal>UTF-32LE</literal>,
+ <literal>UCS-2LE</literal>,
+ <literal>UTF-16</literal>,
+ <literal>UTF-16BE</literal>,
+ <literal>UTF-16LE</literal>,
+ <literal>UTF-8</literal>,
+ <literal>UTF-7</literal>,
+ <literal>ASCII</literal>,
+ <literal>EUC-JP</literal>,
+ <literal>SJIS</literal>,
+ <literal>eucJP-win</literal>,
+ <literal>SJIS-win</literal>,
+ <literal>ISO-2022-JP</literal>,
+ <literal>JIS</literal>,
+ <literal>ISO-8859-1</literal>,
+ <literal>ISO-8859-2</literal>,
+ <literal>ISO-8859-3</literal>,
+ <literal>ISO-8859-4</literal>,
+ <literal>ISO-8859-5</literal>,
+ <literal>ISO-8859-6</literal>,
+ <literal>ISO-8859-7</literal>,
+ <literal>ISO-8859-8</literal>,
+ <literal>ISO-8859-9</literal>,
+ <literal>ISO-8859-10</literal>,
+ <literal>ISO-8859-13</literal>,
+ <literal>ISO-8859-14</literal>,
+ <literal>ISO-8859-15</literal>,
+ <literal>byte2be</literal>,
+ <literal>byte2le</literal>,
+ <literal>byte4be</literal>,
+ <literal>byte4le</literal>,
+ <literal>BASE64</literal>,
+ <literal>7bit</literal>,
+ <literal>8bit</literal> et
+ <literal>UTF7-IMAP</literal>.
+ </para>
+ <para>
+ Les entrées du fichiers <filename>php.ini</filename>, qui acceptent des
+ noms de jeux de caractères, acceptent aussi les valeurs
+ "<literal>auto</literal>" et
+ "<literal>pass</literal>".
+ Les fonctions <literal>mbstring</literal>,qui acceptent des
+ noms de jeux de caractères, acceptent aussi la valeur
+ "<literal>auto</literal>"/
+ </para>
+ <para>
+ Si "<literal>pass</literal>" est utilisée, aucune conversion
+ n'est effectuée.
+ </para>
+ <para>
+ Si "<literal>auto</literal>" est utilisée, elle est
+remplacée
+ par "<literal>ASCII,JIS,UTF-8,EUC-JP,SJIS</literal>".
+ </para>
+ <para>
+ Voir aussi <function>mb_detect_order</function>.
+ </para>
+ <note>
+ <para>
+ Un jeu de caractère supporté n'est pas forcément un bon
+choix comme
+ jeu de caractères interne.
+ </para>
+ </note>
+ </sect2>
+ <sect2 id="mb-ini">
+ <title>Configuration php.ini</title>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <literal>mbstring.internal_encoding</literal> définit le jeu
+ de caractères interne par défaut.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>mbstring.http_input</literal> définit le jeu
+ de caractères d'entrée HTTP par défaut.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>mbstring.http_output</literal> defines définit le jeu
+ de caractères d'affichage HTTP par défaut.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>mbstring.detect_order</literal> définit l'ordre de
+détection
+ des jeux de caractères (lors de la lecture sur une source externe.
+ Voir aussi la fonction <function>mb_detect_order</function>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>mbstring.substitute_character</literal> définit le
+ caractère de substitution pour les codes invalides.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ Les navigateurs web utilisent tout le temps le même encodage lorsqu'ils
+ émettent les données d'un formulaire. Cependant, les navigateurs
+peuvent
+ ne pas tous utiliser le même encodage. Voyez la fonction
+ <function>mb_http_input</function> pour détecter les jeux de
+caractères
+ utilisés par les navigateurs.
+ </para>
+ <para>
+ Si <literal>enctype</literal> vaut <literal>multipart/form-data</literal> dans
+ un formulaire HTML, <literal>mbstring</literal> n'effectue aucune conversion
+ des données. Il faut les faire manuellement, dans le script.
+ </para>
+ <para>
+ Bien que les navigateurs soivent généralement assez intelligents
+pour
+ détecter les jeux de caractères automatiquement,
+ il est recommandé de l'indiquer dans l'en-tête
+ <literal>charset</literal>. Modifiez <literal>default_charset</literal>
+ en fonction du jeu de caractères.
+ </para>
+ <para>
+ <example>
+ <title>Exemple de configuration <filename>php.ini</filename> pour
+mbstring</title>
+ <programlisting role="php">
+;; Set default internal encoding
+;; Note: Make sure to use character encoding works with PHP
+mbstring.internal_encoding = UTF-8 ; Set internal encoding to UTF-8
+;; Set default HTTP input character encoding
+;; Note: Script cannot change http_input setting.
+mbstring.http_input = pass ; No conversion.
+mbstring.http_input = auto ; Set HTTP input to auto
+ ; "auto" is expanded to
+"ASCII,JIS,UTF-8,EUC-JP,SJIS"
+mbstring.http_input = SJIS ; Set HTTP2 input to SJIS
+mbstring.http_input = UTF-8,SJIS,EUC-JP ; Specify order
+;; Set default HTTP output character encoding
+mbstring.http_output = pass ; No conversion
+mbstring.http_output = UTF-8 ; Set HTTP output encoding to UTF-8
+;; Set default character encoding detection order
+mbstring.detect_order = auto ; Set detect order to auto
+mbstring.detect_order = ASCII,JIS,UTF-8,SJIS,EUC-JP ; Specify order
+;; Set default substitute character
+mbstring.substitute_character = 12307 ; Specify Unicode value
+mbstring.substitute_character = none ; Do not print character
+mbstring.substitute_character = long ; Long Example: U+3000,JIS+7E7E
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Exemple de configuration <filename>php.ini</filename> pour
+ mbstring pour utiliser <literal>EUC-JP</literal></title>
+ <programlisting role="php">
+;; Disable Output Buffering
+output_buffering = Off
+;; Set HTTP header charset
+default_charset = EUC-JP
+;; Set HTTP input encoding conversion to auto
+mbstring.http_input = auto
+;; Convert HTTP output to EUC-JP
+mbstring.http_output = EUC-JP
+;; Set internal encoding to EUC-JP
+mbstring.internal_encoding = EUC-JP
+;; Do not print invalid characters
+mbstring.substitute_character = none
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Exemple de configuration <filename>php.ini</filename> pour
+ mbstring pour utiliser <literal>SJIS</literal></title>
+ <programlisting role="php">
+;; Enable Output Buffering
+output_buffering = On
+;; Set mb_output_handler to enable output conversion
+output_handler = mb_output_handler
+;; Set HTTP header charset
+default_charset = Shift_JIS
+;; Set http input encoding conversion to auto
+mbstring.http_input = auto
+;; Convert to SJIS
+mbstring.http_output = SJIS
+;; Set internal encoding to EUC-JP
+mbstring.internal_encoding = EUC-JP
+;; Do not print invalid characters
+mbstring.substitute_character = none
+ </programlisting>
+ </example>
+ </para>
+ </sect2>
<sect2 id="mb-ja-basic">
<title>Cas des caractères japonais</title>
<para>
@@ -57,8 +463,8 @@
à comparer avec les caractères simple-octet traditionnellement
utilisé. Les caractères les plus gros sont appelés
"zen-kaku"
(i.e. grande largeur) et les plus petits sont appelés "han-kaku"
- (i.e. demi-largeur). Les caractères "zen-kaku" sont
généralement de taille
- constante.
+ (i.e. demi-largeur). Les caractères "zen-kaku" sont
+ généralement de taille constante.
</simpara>
</listitem>
<listitem>
@@ -70,8 +476,8 @@
<listitem>
<simpara>
Les bases de données allouent des tailles de stockages différentes
- de celles utilisées par PHP, même si le même encodage de
caractère
- est utilisé (par exemple, PostGreSQL).
+ de celles utilisées par PHP, même si le même encodage
+ de caractère est utilisé (par exemple, PostGreSQL).
</simpara>
</listitem>
<listitem>
@@ -87,112 +493,129 @@
</itemizedlist>
</para>
</sect2>
- <sect2 id="mb-code">
- <title>Jeux de caractères supportés</title>
- <para>
- Les jeux de caractères suivants sont supportés par cette extension
PHP :
- <literal>UCS-4</literal>,
- <literal>UCS-4BE</literal>,
- <literal>UCS-4LE</literal>,
- <literal>UCS-2</literal>,
- <literal>UCS-2BE</literal>,
- <literal>UCS-2LE</literal>,
- <literal>UTF-32</literal>,
- <literal>UTF-32BE</literal>,
- <literal>UTF-32LE</literal>,
- <literal>UCS-2LE</literal>,
- <literal>UTF-16</literal>,
- <literal>UTF-16BE</literal>,
- <literal>UTF-16LE</literal>,
- <literal>UTF-8</literal>,
- <literal>UTF-7</literal>,
- <literal>ASCII</literal>,
- <literal>EUC-JP</literal>,
- <literal>SJIS</literal>,
- <literal>eucJP-win</literal>,
- <literal>SJIS-win</literal>,
- <literal>ISO-2022-JP</literal>(<literal>JIS</literal>),
- <literal>ISO-8859-1</literal>,
- <literal>ISO-8859-2</literal>,
- <literal>ISO-8859-3</literal>,
- <literal>ISO-8859-4</literal>,
- <literal>ISO-8859-5</literal>,
- <literal>ISO-8859-6</literal>,
- <literal>ISO-8859-7</literal>,
- <literal>ISO-8859-8</literal>,
- <literal>ISO-8859-9</literal>,
- <literal>ISO-8859-10</literal>,
- <literal>ISO-8859-13</literal>,
- <literal>ISO-8859-14</literal>,
- <literal>ISO-8859-15</literal>.
- </para>
- </sect2>
- <sect2 id="mb-ini">
- <title>Configuration du fichier php.ini</title>
- <para>
- <itemizedlist>
- <listitem>
- <simpara>
- <literal>mbstring.internal_encoding</literal> définit le jeu
- de caractères interne par défaut.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>mbstring.http_input</literal> définit le jeu
- de caractères d'entrée HTTP par défaut.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>mbstring.http_output</literal> defines définit le jeu
- de caractères d'affichage HTTP par défaut.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>mbstring.detect_order</literal> définit l'ordre de
détection
- des jeux de caractères (lors de la lecture sur une source externe
- inconnue).
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>mbstring.substitute_character</literal> définit le
- caractère de substitution pour les codes invalides.
- </simpara>
- </listitem>
- </itemizedlist>
- </para>
- <para>
- <example>
- <title>Exemple de configuration du <literal>php.ini</literal></title>
- <programlisting role="php.ini">
-;; Set default internal encoding
-mbstring.internal_encoding = UTF-8 ; Par défaut, to UTF-8
-;; Set default HTTP input character code
-mbstring.http_input = auto ; Par défaut, mode automatique
-; or
-; mbstring.http_input = SJIS ; Par défaut, HTTP fournit du code SJIS
-; mbstring.http_input = eucjp-win, sjis-win, UTF-8 ; Ordre spécifique
-;; Set default HTTP output character code
-mbstring.http_output = UTF-8 ; Par défaut, HTTP affiche du code UTF-8
-;; Set default character code detection order
-mbstring.detect_order = auto ; Par défaut, mode automatique
-; or
-; mbstring.detect_order = eucjp-win, sjis-win, UTF-8 ; Ordre spécifique
-;; Set default substitute character
-mbstring.substitute_character = 12307 ; Spécifie un code de caractère
-; or
-; mbstring.substitute_character = none ; Caractère NULL
-; mbstring.substitute_character = long ; Long
- </programlisting>
- </example>
- </para>
- </sect2>
+ <sect2 id="mb-ref">
+ <title>Références</title>
+ <para>
+ Les jeux de caractères multi-octets et leurs techniques sont très
+complexes.
+ Il n'est pas possible de couvrir tous les aspects en détails ici.
+Reportez-vous aux
+ URL suivantes, pour d'autres ressouces complémentaires :
+ <itemizedlist>
+ <listitem>
+ <para>
+ Unicode/UTF/UCS/etc
+ </para>
+ <para>
+ <literal>http://www.unicode.org/</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Japanais/coréen/Chinois
+ </para>
+ <para>
+ <literal>
+ ftp://ftp.ora.com/pub/examples/nutshell/ujip/doc/cjk.inf
+ </literal>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </sect2>
</sect1>
</partintro>
- <refentry id="function.mb-internal-encoding">
+ <refentry id="function.mb-language">
+ <refnamediv>
+ <refname>mb_language</refname>
+ <refpurpose>Lit/modifie le langage courant</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>mb_language</function></funcdef>
+ <paramdef>string
+ <parameter><optional>language</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>mb_language</function> remplace le langage courant par
+ <parameter>language</parameter>. Si <parameter>language</parameter> est omis,
+ <function>mb_language</function> retourne le langage courant.
+ </para>
+ <para>
+ Le paramètre <parameter>language</parameter> sert à encoder les
+ messages électroniques. Les langages valies sont :
+ "Japanese" (japonais), "ja" (japonais), "English" (anglais), "en"
+ (anglais) and "uni" (UTF-8). <function>mb_send_mail</function> utilise cette
+ option pour encoder les emails.
+ </para>
+ <para>
+ Le langage et sa configuration valle <literal>ISO-2022-JP/Base64</literal>
+ poru le japonais, <literal>UTF-8/Base64</literal> pour l'UTF-8 et
+ <literal>ISO-8859-1/quoted printable</literal> pour l'anglais.
+ </para>
+ <para>
+ Si <parameter>language</parameter> est fourni et valide,
+ <function>mb_language</function> retourne &true;.
+ Sinon, elle retourne &false;. Lorsque le paramètre
+ <parameter>language</parameter> est omis, <function>mb_language</function>
+retourne
+ le nom du langage courant, sous forme de chaîne. Si aucun langage n'avait
+ été configuré, <function>mb_language</function> retourne
+&false;.
+ </para>
+ <para>
+ Voir aussi
+ <function>mb_send_mail</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.mb-parse-str">
+ <refnamediv>
+ <refname>mb_parse_str</refname>
+ <refpurpose>
+ Analyse les données HTTP GET/POST/COOKIE et assigne les variables
+globales
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>mb_parse_str</function>
+ </funcdef>
+ <paramdef>string
+ <parameter>encoded_string</parameter>
+ </paramdef>
+ <paramdef>array
+ <parameter><optional>result</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>mb_parse_str</function> analyse les données d'entrées
+ HTTP GET/POST/COOKIE et assigne les variables globales. Etant donné
+ que PHP ne fournit pas de valeurs brutes de POST/COOKIE, cette
+ fonction n'est utilisable que sur les données en méthode GET.
+ <function>mb_parse_str</function> prend les données de l'URL appelante,
+ détecte le jeu de caractères, converti les données en jeu
+de caractères
+ interne, et affecte les valeurs au tableau de variables globales.
+ </para>
+ <para>
+ <parameter>encoded_string</parameter>: Les données encodées de
+l'URL.
+ </para>
+ <para>
+ <parameter>result</parameter>: Un tableau contenant les valeurs
+décodées,
+ et les noms des jeux de caractères.
+ </para>
+ <para>
+ <function>mb_parse_str</function> retourne &true; en
+ cas de succès, et &false; sinon.
+ </para>
+ <para>
+ Voir aussi
+ <function>mb_detect_order</function> et
+ <function>mb_internal_encoding</function>.
+ </para>
+ </refsect1>
+ </refentry> <refentry id="function.mb-internal-encoding">
<refnamediv>
<refname>mb_internal_encoding</refname>
<refpurpose>
@@ -234,7 +657,7 @@
<example>
<title>Exemple avec <function>mb_internal_encoding</function></title>
<programlisting role="php">
-<?php
+<?;php
/* Utilise l'encodage interne UTF-8 */
mb_internal_encoding("UTF-8");
/* Affiche l'encodage interne courant */
@@ -367,7 +790,7 @@
<example>
<title>Exemple avec <function>mb_detect_order</function></title>
<programlisting role="php">
-<?php
+<?php
/* Remplace l'ordre de détection par une liste énumérée */
mb_detect_order("eucjp-win,sjis-win,UTF-8");
/* Remplace l'ordre de détection par un tableau */
@@ -443,7 +866,7 @@
<example>
<title>Exemple avec <function>mb_substitute_character</function></title>
<programlisting role="php">
-<?php
+<?php
/* Configure le caractère de substitution avec U+3013 (GETA MARK) */
mb_substitute_character(0x3013);
/* Configure le caractère de substitution avec un format
héxadécimal */
@@ -491,7 +914,7 @@
<example>
<title>Exemple avec <function>mb_output_handler</function></title>
<programlisting role="php">
-<?php
+<?php
mb_http_output("UTF-8");
ob_start("mb_output_handler");
?>
@@ -534,7 +957,7 @@
<example>
<title>Exemple avec <function>mb_preferred_mime_string</function></title>
<programlisting role="php">
-<?php
+<?php
$outputenc = "sjis-win";
mb_http_output($outputenc);
ob_start("mb_output_handler");
@@ -821,7 +1244,7 @@
</para>
</refsect1>
</refentry>
- <refentry id="function.mb-strmwidth">
+ <refentry id="function.mb-strimwidth">
<refnamediv>
<refname>mb_strimwidth</refname>
<refpurpose>Tronque une chaîne</refpurpose>
@@ -862,7 +1285,7 @@
<example>
<title>Exemple avec <function>mb_strimwidth</function></title>
<programlisting role="php">
-<?php
+<?;php
$str = mb_strimwidth($str, 0, 40, "..>");
?>
</programlisting>
@@ -911,7 +1334,7 @@
<example>
<title>Exemple avec <function>mb_convert_encoding</function></title>
<programlisting role="php">
-<?php
+<?php
/* Convertit l'encodage interne vers SJIS */
$str = mb_convert_encoding($str, "SJIS");
/* Convertit EUC-JP en UTF-7 */
@@ -965,7 +1388,7 @@
<example>
<title>Exemple avec <function>mb_detect_encoding</function></title>
<programlisting role="php">
-<?php
+<?php
/* Détecte l'encodage avec les valeurs par défaut */
echo mb_detect_encoding($str);
/* "auto" signifie "ASCII,JIS,UTF-8,EUC-JP,SJIS" */
@@ -1047,7 +1470,7 @@
<example>
<title>Exemple avec <function>mb_convert_kana</function></title>
<programlisting role="php">
-<?php
+<?php
/* Convertit tous les "kana" en "zen-kaku" "kata-kana" */
$str = mb_convert_kana($str, "KVC");
/* Convertit "han-kaku" "kata-kana" en "zen-kaku" "kata-kana"
@@ -1104,7 +1527,7 @@
<example>
<title>Exemple avec <function>mb_convert_kana</function></title>
<programlisting role="php">
-<?php
+<?php
$name = ""; // kanji
$mbox = "kru";
$doma = "gtinn.mon";
@@ -1186,7 +1609,7 @@
<example>
<title>Exemple avec <function>mb_convert_variables</function></title>
<programlisting role="php">
-<?php
+<?php
/* Convertit les variables $post1, $post2 en encodage interne */
$interenc = mb_internal_encoding();
$inputenc = mb_convert_variables($interenc, "ASCII,UTF-8,SJIS-win", $post1, $post2);
@@ -1232,7 +1655,7 @@
<example>
<title>Exemple de paramètre <parameter>convmap</parameter></title>
<programlisting role="php">
-<?php
+<?php
$convmap = array (
int start_code1, int end_code1, int offset1, int mask1,
int start_code2, int end_code2, int offset2, int mask2,
@@ -1249,7 +1672,7 @@
<example>
<title>Exemple avec <function>mb_encode_numericentity</function></title>
<programlisting role="php">
-<?php
+<?php
/* Convertit du ISO-8859-1 en entités HTML */
$convmap = array(0x80, 0xff, 0, 0xff);
$str = mb_encode_numericentity($str, $convmap, "ISO-8859-1");
Index: phpdoc/fr/functions/ldap.xml
diff -u phpdoc/fr/functions/ldap.xml:1.10 phpdoc/fr/functions/ldap.xml:1.11
--- phpdoc/fr/functions/ldap.xml:1.10 Tue Jul 31 02:52:45 2001
+++ phpdoc/fr/functions/ldap.xml Wed Nov 14 16:23:12 2001
@@ -1,3 +1,5 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.11 $ -->
<reference id="ref.ldap">
<title>LDAP</title>
<titleabbrev>LDAP</titleabbrev>
@@ -199,8 +201,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ldap_add</function> retourne <literal>TRUE</literal> en cas de
succès,
- ou <literal>FALSE</literal> en cas d'erreur.
+ <function>ldap_add</function> retourne &true; en cas de succès,
+ ou &true; en cas d'erreur.
</para><para>
<function>ldap_add</function> sert à ajouter une entrée
dans un dossier LDAP. Le ND de l'entrée sera ajouté à
@@ -221,7 +223,7 @@
<title>Exemple complet avec lien authentifié</title>
<programlisting role="php">
<?php
- $ds=ldap_connect("localhost");
+ $ds=ldap_connect("localhost");
// On suppose que le serveur LDAP est sur cet hôte
if ($ds) {
// liaison avec le nd approprié, pour avoir un accès en modification
@@ -261,8 +263,8 @@
<function>ldap_bind</function> lie un serveur LDAP avec le RDN
<parameter>bind_rdn</parameter> et mot de passe
<parameter>bind_password</parameter>. <function>ldap_bind</function> retourne
- <literal>TRUE</literal> en cas de succès, et
- <literal>FALSE</literal> sinon.
+ &true; en cas de succès, et
+ &true; sinon.
</para>
<para>
<function>ldap_bind</function> effectue une opération de liaison
@@ -286,8 +288,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ldap_close</function> retourne <literal>TRUE</literal> en cas de
succès,
- et <literal>FALSE</literal> sinon.
+ <function>ldap_close</function> retourne &true; en cas de succès,
+ et &true; sinon.
</para>
<para>
<function>ldap_close</function> ferme le lien au serveur LDAP
@@ -318,7 +320,7 @@
</funcprototype>
</funcsynopsis>
<simpara>
- <function>ldap_compare</function> retournr <literal>TRUE</literal> si
+ <function>ldap_compare</function> retournr &true; si
<parameter>value</parameter> un fichier correspond à la recherche; retourne
-1 si une erreur survient.
</simpara>
@@ -335,7 +337,7 @@
<title>Vérification d'un mot de passe avec LDAP</title>
<programlisting role="php">
<?php
- $ds=ldap_connect("localhost");
+ $ds=ldap_connect("localhost");
// on suppose que le serveur LDAP est sur le serveur local
if ($ds) {
// liaison
@@ -348,9 +350,9 @@
$r=ldap_compare($ds, $dn, $attr, $value);
if ($r === -1) {
echo "Erreur: ".ldap_error($ds);
- } elseif ($r === <literal>TRUE</literal>) {
+ } elseif ($r === &true;) {
echo "Mot de passe correct.";
- } elseif ($r === <literal>FALSE</literal>) {
+ } elseif ($r === &true;) {
echo "Mot de passe erroné!";
}
} else {
@@ -391,7 +393,7 @@
</funcsynopsis>
<para>
<function>ldap_connect</function> retourne un identifiant positif de serveur
- LDAP en cas de succès, ou bien <literal>FALSE</literal> en cas d'erreur.
+ LDAP en cas de succès, ou bien &true; en cas d'erreur.
</para>
<para>
<function>ldap_connect</function> établit une connexion avec un serveur.
@@ -428,7 +430,7 @@
</funcsynopsis>
<para>
<function>ldap_count_entries</function> retourne le nombre
- d'entrées en cas de succès, et <literal>FALSE</literal> sinon.
+ d'entrées en cas de succès, et &true; sinon.
</para>
<para>
<function>ldap_count_entries</function> retourne le nombre d'entrées
@@ -453,8 +455,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ldap_delete</function> retourne <literal>TRUE</literal> en cas de
succès,
- et <literal>FALSE</literal> sinon.
+ <function>ldap_delete</function> retourne &true; en cas de succès,
+ et &true; sinon.
</para>
<para>
<function>ldap_delete</function> efface une entrée dans un dossier
@@ -509,8 +511,8 @@
numéro d'erreur.
</para>
<para>
- Voir aussi
- <function>ldap_errno</function> et
+ Voir aussi
+ <function>ldap_errno</function> et
<function>ldap_error</function>.
<example>
<title>Enumérer tous les messages d'erreur LDAP</title>
@@ -580,8 +582,8 @@
</example>
</para>
<para>
- Voir aussi
- <function>ldap_err2str</function> et
+ Voir aussi
+ <function>ldap_err2str</function> et
<function>ldap_error</function>.
</para>
</refsect1>
@@ -619,8 +621,8 @@
les affichages, les erreurs LDAP s'afficheront aussi dans le code PHP.
</para>
<para>
- Voir aussi
- <function>ldap_err2str</function> et
+ Voir aussi
+ <function>ldap_err2str</function> et
<function>ldap_errno</function>.
</para>
</refsect1>
@@ -669,7 +671,7 @@
</funcsynopsis>
<para>
<function>ldap_first_attribute</function> retourne le premier attribut
- en cas de succès, et <literal>FALSE</literal> sinon.
+ en cas de succès, et &true; sinon.
</para>
<para>
Le comportement est similaire pour les entrées. Les attributs sont lus
@@ -684,7 +686,7 @@
<function>ldap_next_attribute</function>, qui modifie ce pointeur.
</para>
<para>
- Voir aussi
+ Voir aussi
<function>ldap_get_attributes</function>.
</para>
</refsect1>
@@ -705,7 +707,7 @@
</funcsynopsis>
<para>
<function>ldap_first_entry</function> retourne un identifiant sur la
- première entrée en cas de succès, et
<literal>FALSE</literal> sinon.
+ première entrée en cas de succès, et &true; sinon.
</para>
<para>
Les entrées d'un résultat sont lues séquentiellement,
@@ -716,7 +718,7 @@
accéder à la prochaine entrée.
</para>
<para>
- Voir aussi
+ Voir aussi
<function>ldap_get_entries</function>.
</para>
</refsect1>
@@ -737,8 +739,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ldap_free_result</function> retourne <literal>TRUE</literal> en cas de
- succès, et <literal>FALSE</literal> sinon.
+ <function>ldap_free_result</function> retourne &true; en cas de
+ succès, et &true; sinon.
</para>
<para>
<function>ldap_free_result</function> libère la mémoire
@@ -775,7 +777,7 @@
</funcsynopsis>
<para>
<function>ldap_get_attributes</function> retourne un tableau multi-dimensionel
- en cas de succès, et <literal>FALSE</literal> sinon.
+ en cas de succès, et &true; sinon.
</para>
<para>
<function>ldap_get_attributes</function> sert à simplifier la lecture
@@ -810,7 +812,7 @@
</example>
</para>
<para>
- Voir aussi
+ Voir aussi
<function>ldap_first_attribute</function> et
<function>ldap_next_attribute</function>.
</para>
@@ -832,7 +834,7 @@
</funcsynopsis>
<para>
<function>ldap_get_dn</function> retourne le DN de l'entrée
- en cas de succès, et <literal>FALSE</literal> sinon.
+ en cas de succès, et &true; sinon.
</para>
<para>
<function>ldap_get_dn</function> sert à obtenir le ND d'une
@@ -856,7 +858,7 @@
</funcsynopsis>
<para>
<function>ldap_get_entries</function> retourne un tableau multi-dimensionnel
- en cas de succès, et <literal>FALSE</literal> sinon.
+ en cas de succès, et &true; sinon.
</para>
<para>
<function>ldap_get_entries</function> sert à simplifier la lecture
@@ -881,7 +883,7 @@
</informalexample>
</para>
<para>
- Voir aussi
+ Voir aussi
<function>ldap_first_entry</function> et
<function>ldap_next_entry</function>.
</para>
@@ -905,7 +907,7 @@
<para>
<function>ldap_get_option</function> remplace la valeur courante de
l'option <parameter>option</parameter> par <parameter>retval</parameter>,
- et retourne <literal>TRUE</literal> en cas de succès,
<literal>FALSE</literal> sinon.
+ et retourne &true; en cas de succès, &true; sinon.
</para>
<para>
Le paramètre <parameter>option</parameter> peut prendre l'une des valeurs :
@@ -935,7 +937,7 @@
</example>
</para>
<para>
- Voir aussi
+ Voir aussi
<function>ldap_set_option</function>.
</para>
</refsect1>
@@ -957,7 +959,7 @@
</funcsynopsis>
<para>
<function>ldap_get_option</function> retourne un tableau de valeurs en
- cas de succès, et <literal>FALSE</literal> sinon.
+ cas de succès, et &true; sinon.
</para>
<para>
<function>ldap_get_values</function> sert à lire toutes les valeurs
@@ -1027,7 +1029,7 @@
</funcsynopsis>
<para>
<function>ldap_get_values_len</function> retourne un tableau de valeurs
- pour l'attribut, ou bien <literal>FALSE</literal> en cas d'erreur.
+ pour l'attribut, ou bien &true; en cas d'erreur.
</para>
<para>
<function>ldap_get_values_len</function> sert à lire toutes les
@@ -1075,8 +1077,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ldap_list</function> retourne <literal>TRUE</literal> en cas de
succès,
- et <literal>FALSE</literal> sinon.
+ <function>ldap_list</function> retourne &true; en cas de succès,
+ et &true; sinon.
</para>
<para>
<function>ldap_list</function> effecture une recherche avec le filtre7
@@ -1125,8 +1127,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ldap_modify</function> retourne <literal>TRUE</literal> en cas de
succès,
- et <literal>FALSE</literal> sinon.
+ <function>ldap_modify</function> retourne &true; en cas de succès,
+ et &true; sinon.
</para>
<para>
<function>ldap_modify</function> sert à modifier les entrées
@@ -1151,8 +1153,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ldap_mod_add</function> retourne <literal>TRUE</literal> en cas de
- succès, et <literal>FALSE</literal> sinon.
+ <function>ldap_mod_add</function> retourne &true; en cas de
+ succès, et &true; sinon.
</para>
<para>
<function>ldap_mod_add</function> ajoute les attributs
<parameter>entry</parameter>
@@ -1179,8 +1181,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ldap_mod_del</function> retourne <literal>TRUE</literal> en cas de
- succès, et <literal>FALSE</literal> sinon.
+ <function>ldap_mod_del</function> retourne &true; en cas de
+ succès, et &true; sinon.
</para>
<para>
<function>ldap_mod_del</function> efface les attributs
<parameter>entry</parameter>
@@ -1207,8 +1209,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ldap_mod_replace</function> retourne <literal>TRUE</literal> en cas de
- succès, et <literal>FALSE</literal> sinon.</para>
+ <function>ldap_mod_replace</function> retourne &true; en cas de
+ succès, et &true; sinon.</para>
<para>
<function>ldap_mod_replace</function> remplace les attributs
<parameter>entry</parameter> à l'entrée <parameter>dn</parameter>.
@@ -1247,7 +1249,7 @@
<function>ldap_first_attribute</function>.
</para>
<para>
- Voir aussi
+ Voir aussi
<function>ldap_get_attributes</function>.
</para>
</refsect1>
@@ -1270,7 +1272,7 @@
<function>ldap_next_entry</function> retourne l'identifiant de
l'entrée suivante, dans le résultat qui a été
initialisé par <function>ldap_first_entry</function>. S'il n'y a
- plus d'entrée, retourne <literal>FALSE</literal>.
+ plus d'entrée, retourne &true;.
</para>
<para>
<function>ldap_next_entry</function> sert à retrouver toutes les
@@ -1283,7 +1285,7 @@
<function>ldap_first_entry</function>.
</para>
<para>
- Voir aussi
+ Voir aussi
<function>ldap_get_entries</function>.
</para>
</refsect1>
@@ -1319,7 +1321,7 @@
</funcsynopsis>
<para>
<function>ldap_read</function> retourne un identifiant de résultat
- en cas de succès, et <literal>FALSE</literal> sinon.
+ en cas de succès, et &true; sinon.
</para>
<para>
<function>ldap_read</function> effectue une recherche avec le filter
@@ -1340,7 +1342,8 @@
</para>
<note>
<para>
- Ces paramètres optionnels ont été ajoutés à
partir de la version 4.0.2:
+ Ces paramètres optionnels ont été ajoutés à
+ partir de la version 4.0.2:
<parameter>attrsonly</parameter>,
<parameter>sizelimit</parameter>,
<parameter>timelimit</parameter>,
@@ -1371,10 +1374,10 @@
<parameter>dn</parameter>. Le nouveau RDN est spécifié par
<parameter>newrdn</parameter> et le nouveau père est
spécifié par
<parameter>newparent</parameter>. Si le paramètre
- <parameter>deleteoldrdn</parameter> est <literal>TRUE</literal>,
+ <parameter>deleteoldrdn</parameter> est &true;,
l'ancienne valeur sera supprimée et la nouvelle valeur sera
- retenue. <function>ldap_rename</function> retourne <literal>TRUE</literal>
- en cas de succès, et <literal>FALSE</literal> sinon.
+ retenue. <function>ldap_rename</function> retourne &true;
+ en cas de succès, et &true; sinon.
</para>
<para>
<function>ldap_rename</function> ne fonctionne qu'avec LDAPv3.
@@ -1419,7 +1422,7 @@
</funcsynopsis>
<para>
<function>ldap_search</function> retourne un identifiant de résultat
- en cas de succès, et <literal>FALSE</literal> sinon.
+ en cas de succès, et &true; sinon.
</para>
<para>
<function>ldap_search</function> effectue une recherche avec le filtre
@@ -1496,16 +1499,18 @@
</itemizedlist>
</para>
<para>
- Ces paramètres optionnels ont été ajoutés à
partir de la version 4.0.2:
+ Ces paramètres optionnels ont été ajoutés à
+ partir de la version 4.0.2:
<parameter>attrsonly</parameter>,
<parameter>sizelimit</parameter>,
<parameter>timelimit</parameter>,
<parameter>deref</parameter>.
</para>
<para>
- La chaîne de filtre peut être simple ou complexe. Elle utilise les
opérateurs
- booléens au même format que celui décrit dans les
documentations LDAP.
- (Allez voir celle de <ulink url="&url.ldap.netscape;">Netscape Directory
SDK</ulink>
+ La chaîne de filtre peut être simple ou complexe. Elle utilise
+ les opérateurs booléens au même format que celui
+ décrit dans les documentations LDAP (Allez voir celle de
+ <ulink url="&url.ldap.netscape;">Netscape Directory SDK</ulink>
pour plus d'informations sur les filtres).
</para>
<para>
@@ -1552,7 +1557,7 @@
<para>
<function>ldap_set_option</function> remplace la valeur de l'option
<parameter>option</parameter> par <parameter>newval</parameter>, et
- retourn <literal>TRUE</literal> en cas de succès, <literal>FALSE</literal>
sinon.
+ retourn &true; en cas de succès, &true; sinon.
</para>
<para>
Le paramètre <parameter>option</parameter> peut prendre l'une des valeurs
suivantes :
@@ -1571,14 +1576,15 @@
sont des chaînes de caractères. Le premier exemple illustre leur
utilisation.
LDAP_OPT_SERVER_CONTROLS et LDAP_OPT_CLIENT_CONTROLS requiert une liste de
contrôles, ce qui signifie que la valeur peut être un tableau de
contrôles.
- Un contrôle est constitué d'un <emphasis>oid</emphasis> identifiant
le contrôle,
- d'une valeur <emphasis>value</emphasis> optionnelle, et d'un flag optionnel
- de <emphasis>criticalité</emphasis>. En PHP un contrôle est un
tableau
- ayant la clé <emphasis>oid</emphasis> et une valeur sous forme de
chaîne,
- ainsi que deux éléments optionnels. Ces éléments ont
pour clé
+ Un contrôle est constitué d'un <emphasis>oid</emphasis>
+ identifiant le contrôle, d'une valeur <emphasis>value</emphasis>
+ optionnelle, et d'un flag optionnel de <emphasis>criticalité</emphasis>.
+ En PHP un contrôle est un tableau ayant la clé
+<emphasis>oid</emphasis>
+ et une valeur sous forme de chaîne, ainsi que
+ deux éléments optionnels. Ces éléments ont pour
+clé
<emphasis>value</emphasis>, sous forme de chaîne, et une clé
<emphasis>iscritical</emphasis> contenant un booléen.
- Par défaut, <emphasis>iscritical</emphasis> vaut <literal>FALSE</literal>
+ Par défaut, <emphasis>iscritical</emphasis> vaut &true;
Voyez aussi l'exemple ci-dessous.
</para>
<para>
@@ -1606,7 +1612,7 @@
// $ds est un lien valide LDAP
// control n'est pas une valeur
$ctrl1 = array("oid" => "1.2.752.58.10.1", "iscritical" => TRUE);
-// iscritical vaut par défaut <literal>FALSE</literal>
+// iscritical vaut par défaut &true;
$ctrl2 = array("oid" => "1.2.752.58.1.10", "value" => "magic");
// modification des deux contrôles
if (!ldap_set_option($ds, LDAP_OPT_SERVER_CONTROLS, array($ctrl1, $ctrl2)))
@@ -1616,7 +1622,7 @@
</example>
</para>
<para>
- Voir aussi
+ Voir aussi
<function>ldap_get_option</function>.
</para>
</refsect1>
@@ -1635,8 +1641,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ldap_unbind</function> retourne <literal>TRUE</literal>
- en cas de succès, et <literal>FALSE</literal> sinon.
+ <function>ldap_unbind</function> retourne &true;
+ en cas de succès, et &true; sinon.
</para>
<para>
<function>ldap_unbind</function> termine la liaison avec le serveur LDAP.
