cvs: phpdoc /fr/functions ldap.xml mail.xml math.xml mbstring.xml

From:	Damien Seguy	Date:	Wed, 14 Nov 2001 21:23:12 +0000
Subject:	cvs: phpdoc /fr/functions ldap.xml mail.xml math.xml mbstring.xml
Groups:	php.doc
Request:	Send a blank email to phpdoc+get-969338851@lists.php.net to get a copy of this message

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"?> + <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 = "kris@koehntopp.de"; $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 @@ - +<?xml version="1.0" encoding="iso-8859-1"?> + <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> + &note.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> + &note.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> + &note.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"?> + <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"> -&lt?php +&lt?;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"> -&lt?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"> -&lt?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"> -&lt?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"> -&lt?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"> -&lt?php +&lt?;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"> -&lt?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"> -&lt?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"> -&lt?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"> -&lt?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"> -&lt?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"> -&lt?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"> -&lt?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"?> + <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.