cvs: phpdoc-fr /reference/aspell/functions aspell-check-raw.xml /reference/dl .cvsignore /reference/ldap reference.xml /reference/pcre/functions
preg-match-all.xml /reference/zlib/functions gzdeflate.xml gzencode.xml gzgetc.xml gzgetss.xml gzpassthru.xml gzread.xml gzwrite.xml readgzfile.xml
| From: | Damien Seguy | Date: | Mon, 14 Oct 2002 22:38:33 +0000 |
| Subject: | cvs: phpdoc-fr /reference/aspell/functions aspell-check-raw.xml /reference/dl .cvsignore /reference/ldap reference.xml /reference/pcre/functions preg-match-all.xml /reference/zlib/functions gzdeflate.xml gzencode.xml gzgetc.xml gzgetss.xml gzpassthru.xml gzread.xml gzwrite.xml readgzfile.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-77@lists.php.net to get a copy of this message | ||
dams Mon Oct 14 18:38:33 2002 EDT
Removed files:
/phpdoc-fr/reference/dl .cvsignore
Modified files:
/phpdoc-fr/reference/aspell/functions aspell-check-raw.xml
/phpdoc-fr/reference/ldap reference.xml
/phpdoc-fr/reference/pcre/functions preg-match-all.xml
/phpdoc-fr/reference/zlib/functions gzdeflate.xml gzencode.xml
gzgetc.xml gzgetss.xml
gzpassthru.xml gzread.xml
gzwrite.xml readgzfile.xml
Log:
remove extra file
Index: phpdoc-fr/reference/aspell/functions/aspell-check-raw.xml diff -u phpdoc-fr/reference/aspell/functions/aspell-check-raw.xml:1.1 phpdoc-fr/reference/aspell/functions/aspell-check-raw.xml:1.2 --- phpdoc-fr/reference/aspell/functions/aspell-check-raw.xml:1.1 Sun Apr 14 20:22:13 2002 +++ phpdoc-fr/reference/aspell/functions/aspell-check-raw.xml Mon Oct 14 18:38:22 2002 @@ -26,14 +26,16 @@ <example> <title>Exemple avec <function>aspell_check_raw</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $aspell_link = aspell_new("french"); if (aspell_check_raw($aspell_link,"testt")) { echo "L'orthographe est OK"; } else { echo "Attention : faute d'orthographe"; } -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/ldap/reference.xml diff -u phpdoc-fr/reference/ldap/reference.xml:1.3 phpdoc-fr/reference/ldap/reference.xml:1.4 --- phpdoc-fr/reference/ldap/reference.xml:1.3 Wed Jul 31 15:37:02 2002 +++ phpdoc-fr/reference/ldap/reference.xml Mon Oct 14 18:38:24 2002 @@ -1,15 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <reference id="ref.ldap"> <title>LDAP</title> <titleabbrev>LDAP</titleabbrev> <partintro> <section id="ldap.intro"> - <title>Introduction à LDAP</title> + &reftitle.intro; <para> LDAP siginifie : Lightweight Directory Access Protocol - (Protocole Léger d'Accès aux Dossiers). C'est un protocole + (Protocole d'accès aux annuaires léger). C'est un protocole utilisé pour accéder aux "serveurs de dossiers". Ces serveurs sont des bases de données particulières, qui stockent les informations sous forme d'arborescence. @@ -61,8 +61,67 @@ ne connaissiez sa structure, de même que vous ne pouvez une base de données sans en connaître les tables et les bases. </para> + <para> + Bien plus d'informations sont disponibles aux URL suivantes (en anglais) : + </para> + + <itemizedlist> + <listitem> + <para> + <ulink url="&url.ldap.netscape;">Netscape</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="&url.ldap.michigan;">University of Michigan</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="&url.ldap.openldap;">OpenLDAP Project</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="&url.ldap.ldapworld;">LDAP World</ulink> + </para> + </listitem> + </itemizedlist> + + <para> + Le SDK Netscape contient un guide du programmeur très utile, au format + HTML (et en anglais). + </para> + + </section> + + <section id="ldap.requirements"> + &reftitle.required; + <para> + Vous devez tlcharger et compiler les librairies clients + LDAP, soit celles de University of Michigan ldap-3.3, + soit le Netscape Directory SDK 3.0. + </para> + </section> + + <section id="ldap.installation"> + &reftitle.install; + <para> + Le support LDAP de PHP n'est pas activ par dfaut. Vous devez + utiliser l'option de configuration + <link linkend="install.configure.with-ldap">--with-ldap</link> + lorsque vous compilez PHP. + </para> + </section> + + &reference.ldap.ini; + + <section id="ldap.resources"> + &reftitle.resources; + &no.resource; </section> + &reference.ldap.constants; <section id="ldap-example"> <title>Exemple complet de code LDAP</title> <para> @@ -122,13 +181,6 @@ <section id="ldap.using"> <title>Utiliser les fonctions LDAP de PHP</title> <para> - Vous devez télécharger et compiler le client LDAP et les - librairies provenant du package de l'université du Michigan - (ldap-3.3 package) ou le Netscape Directory SDK 3.0. Vous aurez aussi - besoin de recompiler PHP avec le support LDAP pour que les fonctions - qui suivent soient disponibles. - </para> - <para> Avant d'utiliser les fonctions LDAP, vous devez connaître <itemizedlist> <listitem> @@ -150,12 +202,12 @@ requièrent des mots de passe pour tout le reste. </para> </listitem> - </itemizedlist></para> - - <para> - La séquence LDAP typique que vous exécuterez sera la - suivante : -<literallayout> + </itemizedlist> + </para> + <para> + La séquence LDAP typique que vous exécuterez sera la + suivante : + <literallayout> ldap_connect() // établit une connexion au serveur | ldap_bind() // connexion anonyme ou identifiée @@ -164,49 +216,11 @@ modifications, puis affichage du résultat. | ldap_close() // déconnexion -</literallayout></para> - </section> - - <section id="ldap.moreinfo"> - <title>More Information</title> - <para> - Bien plus d'informations sont disponibles aux URL suivantes (en anglais) : - </para> - - <itemizedlist> - <listitem> - <para> - <ulink url="&url.ldap.netscape;">Netscape</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.ldap.michigan;">University of Michigan</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.ldap.openldap;">OpenLDAP Project</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.ldap.ldapworld;">LDAP World</ulink> - </para> - </listitem> - </itemizedlist> - - <para> - Le SDK Netscape contient un guide du programmeur très utile, au format - HTML (et en anglais). - </para> + </literallayout> + </para> </section> - </section> - </partintro> - &reference.ldap.functions; - </reference> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc-fr/reference/pcre/functions/preg-match-all.xml diff -u phpdoc-fr/reference/pcre/functions/preg-match-all.xml:1.1 phpdoc-fr/reference/pcre/functions/preg-match-all.xml:1.2 --- phpdoc-fr/reference/pcre/functions/preg-match-all.xml:1.1 Sun Apr 14 20:36:28 2002 +++ phpdoc-fr/reference/pcre/functions/preg-match-all.xml Mon Oct 14 18:38:26 2002 @@ -39,21 +39,27 @@ parenthèse capturante, etc.. <informalexample> <programlisting role="php"> -<?php -preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>example: </b><div align=left>a test</div>", $out, PREG_PATTERN_ORDER); -print $out[0][0].", ".$out[0][1]."\n"; -print $out[1][0].", ".$out[1][1]."\n"; -?> + <![CDATA[ +<?php + preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>example: </b><div align=left>a test</div>", $out, PREG_PATTERN_ORDER); + print $out[0][0].", ".$out[0][1]."\n"; + print $out[1][0].", ".$out[1][1]."\n"; +?> +]]> + + </programlisting> </informalexample> Cet exemple va afficher : <informalexample> <literallayout> <computeroutput> -<b>exemple: </b>, <div align=left>ceci est un test</div> + <![CDATA[ +<b>exemple: </b>, <div align=left>ceci est un test</div> exemple: , ceci est un test +]]> </computeroutput> - </literallayout> + </literallayout> </informalexample> Ainsi, $out[0] est un tableau qui contient les résultats qui satisfont le masque complet, et $out[1] est un tableau qui contient @@ -71,21 +77,29 @@ deuxième série de résultat, etc... <informalexample> <programlisting role="php"> -<?php -preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>exemple: </b><div align=left>un test</div>", $out, PREG_SET_ORDER); -print $out[0][0].", ".$out[0][1]."\n"; -print $out[1][0].", ".$out[1][1]."\n"; -?> + <![CDATA[ +<?php + preg_match_all("|<[^>]+>(.*)</[^>]+>|U", + "<b>exemple: </b><div align=left>un test</div>", + $out, + PREG_SET_ORDER); + print $out[0][0].", ".$out[0][1]."\n"; + print $out[1][0].", ".$out[1][1]."\n"; +?> +]]> + </programlisting> </informalexample> Cet exemple va afficher : <informalexample> <literallayout> <computeroutput> -<b>exemple: </b>, exemple: -<div align=left>un test</div>, un test + <![CDATA[ +<b>exemple: </b>, exemple: +<div align=left>un test</div>, un test +]]> </computeroutput> - </literallayout> + </literallayout> </informalexample> Dans ce cas, $matches[0] est la première série de résultat, et $matches[0][0] contient le texte qui satisfait @@ -112,10 +126,12 @@ Extraction de tous les numéros de téléphone d'un texte. </title> <programlisting role="php"> -<?php + <![CDATA[ +<?php preg_match_all("/\(? (\d{3})? \)? (?(1) [\-\s] ) \d{3}-\d{4}/x", "Appelez 555-1212 ou 1-800-555-1212", $phones); -?> +?> +]]> </programlisting> </example> </para> @@ -123,41 +139,45 @@ <example> <title>Recherche les couples de balises HTML (gourmand)</title> <programlisting role="php"> -<?php + <![CDATA[ +<?php // Cet exemple utilise les références arrières (\\2). // Elles indiquent à l'analyseur qu'il doit trouver quelquechose qu'il // a déjà repéré un peu plus tôt // le nombre 2 indique que c'est le deuxième jeu de parenthèses // capturante qui doit être utilisé (ici, ([\w]+)). // L'antislash est nécessaire ici, car la chaîne est entre guillemets doubles -$html = "<B>Texte en gras</B><a href=salut.html>clique moi</?> -preg_match_all ("/(<([\w]+)[?>]?>)(.*)(<\/\\?>)/", $html, $matches); -for ($i=0; $i< count($matches[0]); $i++) { - echo "trouvé: ".$matches[0][$i]."\n"; - echo "partie 1: ".$matches[1][$i]."\n"; - echo "partie 2: ".$matches[3][$i]."\n"; - echo "partie 3: ".$matches[4][$i]."\n\n"; -} -?> + $html = "<B>Texte en gras</B><a href=salut.html>clique moi</?> + preg_match_all ("/(<([\w]+)[?>]?>)(.*)(<\/\\?>)/", $html, $matches); + for ($i=0; $i< count($matches[0]); $i++) { + echo "trouvé: ".$matches[0][$i]."\n"; + echo "partie 1: ".$matches[1][$i]."\n"; + echo "partie 2: ".$matches[3][$i]."\n"; + echo "partie 3: ".$matches[4][$i]."\n\n"; + } +?> +]]> </programlisting> </example> Cet exemple va produire : <computeroutput> -trouvé: <B>bold text</?> -partie 1: <B> + <![CDATA[ +trouvé: <B>bold text</B> +partie 1: <B> partie 2: Test en gras -partie 3: </B> -trouvé: <a href=salut.html>clique moi</?> -partie 1: <a href=salut.html> +partie 3: </B> +trouvé: <a href=salut.html>clique moi</a> +partie 1: <a href=salut.html> partie 2: clique moi -partie 3: </?> +partie 3: </a> +]]> </computeroutput> </para> <simpara> Voir aussi <function>preg_match</function>, - <function>preg_replace</function> - et <function>preg_split</function>. + <function>preg_replace</function> et + <function>preg_split</function>. </simpara> </refsect1> </refentry> Index: phpdoc-fr/reference/zlib/functions/gzdeflate.xml diff -u phpdoc-fr/reference/zlib/functions/gzdeflate.xml:1.3 phpdoc-fr/reference/zlib/functions/gzdeflate.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzdeflate.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzdeflate.xml Mon Oct 14 18:38:28 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.11 --> <refentry id="function.gzdeflate"> <refnamediv> @@ -31,7 +31,7 @@ Voir aussi <function>gzinflate</function>, <function>gzcompress</function>, - <function>gzuncompress</function>, + <function>gzuncompress</function> et <function>gzencode</function>. </para> </refsect1> Index: phpdoc-fr/reference/zlib/functions/gzencode.xml diff -u phpdoc-fr/reference/zlib/functions/gzencode.xml:1.3 phpdoc-fr/reference/zlib/functions/gzencode.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzencode.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzencode.xml Mon Oct 14 18:38:29 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.4 --> <refentry id="function.gzencode"> <refnamediv> @@ -65,8 +65,8 @@ </para> <para> Voir aussi - <function>gzcompress</function>. - <function>gzuncompress</function>, + <function>gzcompress</function> + <function>gzuncompress,</function> <function>gzdeflate</function> et <function>gzinflate</function>. </para> Index: phpdoc-fr/reference/zlib/functions/gzgetc.xml diff -u phpdoc-fr/reference/zlib/functions/gzgetc.xml:1.3 phpdoc-fr/reference/zlib/functions/gzgetc.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzgetc.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzgetc.xml Mon Oct 14 18:38:29 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.gzgetc"> <refnamediv> @@ -14,7 +14,8 @@ </methodsynopsis> <para> <function>gzgetc</function> retourne une chaîne contenant un - caractère unique (décompressé), lu dans le fichier représenté par + caractère unique (décompressé), lu dans le + fichier représenté par <parameter>zp</parameter>. <function>gzgetc</function> retourne &false; si la fin du fichier est atteinte (tout comme <function>gzeof</function>). Index: phpdoc-fr/reference/zlib/functions/gzgetss.xml diff -u phpdoc-fr/reference/zlib/functions/gzgetss.xml:1.3 phpdoc-fr/reference/zlib/functions/gzgetss.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzgetss.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzgetss.xml Mon Oct 14 18:38:30 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.gzgetss"> <refnamediv> @@ -26,7 +26,8 @@ souhaitez conserver. <note> <para> - <parameter>Allowable_tags</parameter> a été ajouté en PHP 3.0.13, et PHP 4.0b3. + <parameter>Allowable_tags</parameter> a été + ajouté en PHP 3.0.13, et PHP 4.0b3. </para> </note> </para> Index: phpdoc-fr/reference/zlib/functions/gzpassthru.xml diff -u phpdoc-fr/reference/zlib/functions/gzpassthru.xml:1.3 phpdoc-fr/reference/zlib/functions/gzpassthru.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzpassthru.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzpassthru.xml Mon Oct 14 18:38:30 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.gzpassthru"> <refnamediv> @@ -27,7 +27,8 @@ </para> <para> Le fichier est alors fermé lorsque <function>gzpassthru</function> - a terminé sa lecture. <parameter>zp</parameter> n'est plus utilisable. + a terminé sa lecture. <parameter>zp</parameter> n'est plus utilisable + après. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/zlib/functions/gzread.xml diff -u phpdoc-fr/reference/zlib/functions/gzread.xml:1.3 phpdoc-fr/reference/zlib/functions/gzread.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzread.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzread.xml Mon Oct 14 18:38:31 2002 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.gzread"> <refnamediv> <refname>gzread</refname> - <refpurpose>Binary-safe gz-file read</refpurpose> + <refpurpose>Lecture de fichier compressé binaire</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -24,19 +24,25 @@ <informalexample> <programlisting role="php"> <![CDATA[ -// get contents of a gz-file into a string -$filename = "/usr/local/something.txt.gz"; -$zd = gzopen ($filename, "r"); -$contents = gzread ($zd, 10000); -gzclose ($zd); +<?php +// Lit le contenu d'un fichier dans une chaîne + $filename = "/usr/local/something.txt.gz"; + $zd = gzopen($filename, "r"); + $contents = gzread($zd, 10000); + gzclose($zd); +?> ]]> </programlisting> </informalexample> </para> <simpara> - See also <function>gzwrite</function>, <function>gzopen</function>, - <function>gzgets</function>, <function>gzgetss</function>, - <function>gzfile</function>, and <function>gzpassthru</function>. + Voir aussi + <function>gzwrite</function>, + <function>gzopen</function>, + <function>gzgets</function>, + <function>gzgetss</function>, + <function>gzfile</function> et + <function>gzpassthru</function>. </simpara> </refsect1> </refentry> Index: phpdoc-fr/reference/zlib/functions/gzwrite.xml diff -u phpdoc-fr/reference/zlib/functions/gzwrite.xml:1.3 phpdoc-fr/reference/zlib/functions/gzwrite.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzwrite.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzwrite.xml Mon Oct 14 18:38:31 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.gzwrite"> <refnamediv> @@ -20,8 +20,8 @@ <parameter>zp</parameter>. SI le paramètre <parameter>length</parameter> est fourni, l'écriture s'arrêtera lorsque <parameter>length</parameter> octets décompressés - on été écrit, ou à la fin de la chaîne <parameter>string</parameter> : - le premier qui arrive. + on été écrit, ou à la fin de la chaîne + <parameter>string</parameter> : le premier qui arrive. </simpara> <simpara> Notez que si <parameter>length</parameter> est donné, et que Index: phpdoc-fr/reference/zlib/functions/readgzfile.xml diff -u phpdoc-fr/reference/zlib/functions/readgzfile.xml:1.3 phpdoc-fr/reference/zlib/functions/readgzfile.xml:1.4 --- phpdoc-fr/reference/zlib/functions/readgzfile.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/readgzfile.xml Mon Oct 14 18:38:31 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.readgzfile"> <refnamediv> @@ -31,17 +31,19 @@ appelée avec <literal>@readgzfile</literal>. </para> <para> - The file <parameter>filename</parameter> will be opened from the - filesystem and its contents written to standard output. + Le fichier <parameter>filename</parameter> sera ouvert dans le + systme de fichier, et son contenu sera affiché. </para> <para> - You can use the optional second parameter and set it to "1", if - you want to search for the file in the <link - linkend="ini.include-path">include_path</link>, too. + Vous pouvez utiliser le troisième paramètre optionnel en lui donnant la valeur + de <literal>1</literal>, si vous voulez rechercher le fichier dans + l'<link linkend="ini.include-path">include_path</link>. </para> <para> - See also <function>gzpassthru</function>, - <function>gzfile</function>, and <function>gzopen</function>. + Voir aussi + <function>gzpassthru</function>, + <function>gzfile,</function> et + <function>gzopen</function>. </para> </refsect1> </refentry>
Index: phpdoc-fr/reference/aspell/functions/aspell-check-raw.xml diff -u phpdoc-fr/reference/aspell/functions/aspell-check-raw.xml:1.1 phpdoc-fr/reference/aspell/functions/aspell-check-raw.xml:1.2 --- phpdoc-fr/reference/aspell/functions/aspell-check-raw.xml:1.1 Sun Apr 14 20:22:13 2002 +++ phpdoc-fr/reference/aspell/functions/aspell-check-raw.xml Mon Oct 14 18:38:22 2002 @@ -26,14 +26,16 @@ <example> <title>Exemple avec <function>aspell_check_raw</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $aspell_link = aspell_new("french"); if (aspell_check_raw($aspell_link,"testt")) { echo "L'orthographe est OK"; } else { echo "Attention : faute d'orthographe"; } -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/ldap/reference.xml diff -u phpdoc-fr/reference/ldap/reference.xml:1.3 phpdoc-fr/reference/ldap/reference.xml:1.4 --- phpdoc-fr/reference/ldap/reference.xml:1.3 Wed Jul 31 15:37:02 2002 +++ phpdoc-fr/reference/ldap/reference.xml Mon Oct 14 18:38:24 2002 @@ -1,15 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <reference id="ref.ldap"> <title>LDAP</title> <titleabbrev>LDAP</titleabbrev> <partintro> <section id="ldap.intro"> - <title>Introduction à LDAP</title> + &reftitle.intro; <para> LDAP siginifie : Lightweight Directory Access Protocol - (Protocole Léger d'Accès aux Dossiers). C'est un protocole + (Protocole d'accès aux annuaires léger). C'est un protocole utilisé pour accéder aux "serveurs de dossiers". Ces serveurs sont des bases de données particulières, qui stockent les informations sous forme d'arborescence. @@ -61,8 +61,67 @@ ne connaissiez sa structure, de même que vous ne pouvez une base de données sans en connaître les tables et les bases. </para> + <para> + Bien plus d'informations sont disponibles aux URL suivantes (en anglais) : + </para> + + <itemizedlist> + <listitem> + <para> + <ulink url="&url.ldap.netscape;">Netscape</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="&url.ldap.michigan;">University of Michigan</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="&url.ldap.openldap;">OpenLDAP Project</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="&url.ldap.ldapworld;">LDAP World</ulink> + </para> + </listitem> + </itemizedlist> + + <para> + Le SDK Netscape contient un guide du programmeur très utile, au format + HTML (et en anglais). + </para> + + </section> + + <section id="ldap.requirements"> + &reftitle.required; + <para> + Vous devez tlcharger et compiler les librairies clients + LDAP, soit celles de University of Michigan ldap-3.3, + soit le Netscape Directory SDK 3.0. + </para> + </section> + + <section id="ldap.installation"> + &reftitle.install; + <para> + Le support LDAP de PHP n'est pas activ par dfaut. Vous devez + utiliser l'option de configuration + <link linkend="install.configure.with-ldap">--with-ldap</link> + lorsque vous compilez PHP. + </para> + </section> + + &reference.ldap.ini; + + <section id="ldap.resources"> + &reftitle.resources; + &no.resource; </section> + &reference.ldap.constants; <section id="ldap-example"> <title>Exemple complet de code LDAP</title> <para> @@ -122,13 +181,6 @@ <section id="ldap.using"> <title>Utiliser les fonctions LDAP de PHP</title> <para> - Vous devez télécharger et compiler le client LDAP et les - librairies provenant du package de l'université du Michigan - (ldap-3.3 package) ou le Netscape Directory SDK 3.0. Vous aurez aussi - besoin de recompiler PHP avec le support LDAP pour que les fonctions - qui suivent soient disponibles. - </para> - <para> Avant d'utiliser les fonctions LDAP, vous devez connaître <itemizedlist> <listitem> @@ -150,12 +202,12 @@ requièrent des mots de passe pour tout le reste. </para> </listitem> - </itemizedlist></para> - - <para> - La séquence LDAP typique que vous exécuterez sera la - suivante : -<literallayout> + </itemizedlist> + </para> + <para> + La séquence LDAP typique que vous exécuterez sera la + suivante : + <literallayout> ldap_connect() // établit une connexion au serveur | ldap_bind() // connexion anonyme ou identifiée @@ -164,49 +216,11 @@ modifications, puis affichage du résultat. | ldap_close() // déconnexion -</literallayout></para> - </section> - - <section id="ldap.moreinfo"> - <title>More Information</title> - <para> - Bien plus d'informations sont disponibles aux URL suivantes (en anglais) : - </para> - - <itemizedlist> - <listitem> - <para> - <ulink url="&url.ldap.netscape;">Netscape</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.ldap.michigan;">University of Michigan</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.ldap.openldap;">OpenLDAP Project</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.ldap.ldapworld;">LDAP World</ulink> - </para> - </listitem> - </itemizedlist> - - <para> - Le SDK Netscape contient un guide du programmeur très utile, au format - HTML (et en anglais). - </para> + </literallayout> + </para> </section> - </section> - </partintro> - &reference.ldap.functions; - </reference> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc-fr/reference/pcre/functions/preg-match-all.xml diff -u phpdoc-fr/reference/pcre/functions/preg-match-all.xml:1.1 phpdoc-fr/reference/pcre/functions/preg-match-all.xml:1.2 --- phpdoc-fr/reference/pcre/functions/preg-match-all.xml:1.1 Sun Apr 14 20:36:28 2002 +++ phpdoc-fr/reference/pcre/functions/preg-match-all.xml Mon Oct 14 18:38:26 2002 @@ -39,21 +39,27 @@ parenthèse capturante, etc.. <informalexample> <programlisting role="php"> -<?php -preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>example: </b><div align=left>a test</div>", $out, PREG_PATTERN_ORDER); -print $out[0][0].", ".$out[0][1]."\n"; -print $out[1][0].", ".$out[1][1]."\n"; -?> + <![CDATA[ +<?php + preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>example: </b><div align=left>a test</div>", $out, PREG_PATTERN_ORDER); + print $out[0][0].", ".$out[0][1]."\n"; + print $out[1][0].", ".$out[1][1]."\n"; +?> +]]> + + </programlisting> </informalexample> Cet exemple va afficher : <informalexample> <literallayout> <computeroutput> -<b>exemple: </b>, <div align=left>ceci est un test</div> + <![CDATA[ +<b>exemple: </b>, <div align=left>ceci est un test</div> exemple: , ceci est un test +]]> </computeroutput> - </literallayout> + </literallayout> </informalexample> Ainsi, $out[0] est un tableau qui contient les résultats qui satisfont le masque complet, et $out[1] est un tableau qui contient @@ -71,21 +77,29 @@ deuxième série de résultat, etc... <informalexample> <programlisting role="php"> -<?php -preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>exemple: </b><div align=left>un test</div>", $out, PREG_SET_ORDER); -print $out[0][0].", ".$out[0][1]."\n"; -print $out[1][0].", ".$out[1][1]."\n"; -?> + <![CDATA[ +<?php + preg_match_all("|<[^>]+>(.*)</[^>]+>|U", + "<b>exemple: </b><div align=left>un test</div>", + $out, + PREG_SET_ORDER); + print $out[0][0].", ".$out[0][1]."\n"; + print $out[1][0].", ".$out[1][1]."\n"; +?> +]]> + </programlisting> </informalexample> Cet exemple va afficher : <informalexample> <literallayout> <computeroutput> -<b>exemple: </b>, exemple: -<div align=left>un test</div>, un test + <![CDATA[ +<b>exemple: </b>, exemple: +<div align=left>un test</div>, un test +]]> </computeroutput> - </literallayout> + </literallayout> </informalexample> Dans ce cas, $matches[0] est la première série de résultat, et $matches[0][0] contient le texte qui satisfait @@ -112,10 +126,12 @@ Extraction de tous les numéros de téléphone d'un texte. </title> <programlisting role="php"> -<?php + <![CDATA[ +<?php preg_match_all("/\(? (\d{3})? \)? (?(1) [\-\s] ) \d{3}-\d{4}/x", "Appelez 555-1212 ou 1-800-555-1212", $phones); -?> +?> +]]> </programlisting> </example> </para> @@ -123,41 +139,45 @@ <example> <title>Recherche les couples de balises HTML (gourmand)</title> <programlisting role="php"> -<?php + <![CDATA[ +<?php // Cet exemple utilise les références arrières (\\2). // Elles indiquent à l'analyseur qu'il doit trouver quelquechose qu'il // a déjà repéré un peu plus tôt // le nombre 2 indique que c'est le deuxième jeu de parenthèses // capturante qui doit être utilisé (ici, ([\w]+)). // L'antislash est nécessaire ici, car la chaîne est entre guillemets doubles -$html = "<B>Texte en gras</B><a href=salut.html>clique moi</?> -preg_match_all ("/(<([\w]+)[?>]?>)(.*)(<\/\\?>)/", $html, $matches); -for ($i=0; $i< count($matches[0]); $i++) { - echo "trouvé: ".$matches[0][$i]."\n"; - echo "partie 1: ".$matches[1][$i]."\n"; - echo "partie 2: ".$matches[3][$i]."\n"; - echo "partie 3: ".$matches[4][$i]."\n\n"; -} -?> + $html = "<B>Texte en gras</B><a href=salut.html>clique moi</?> + preg_match_all ("/(<([\w]+)[?>]?>)(.*)(<\/\\?>)/", $html, $matches); + for ($i=0; $i< count($matches[0]); $i++) { + echo "trouvé: ".$matches[0][$i]."\n"; + echo "partie 1: ".$matches[1][$i]."\n"; + echo "partie 2: ".$matches[3][$i]."\n"; + echo "partie 3: ".$matches[4][$i]."\n\n"; + } +?> +]]> </programlisting> </example> Cet exemple va produire : <computeroutput> -trouvé: <B>bold text</?> -partie 1: <B> + <![CDATA[ +trouvé: <B>bold text</B> +partie 1: <B> partie 2: Test en gras -partie 3: </B> -trouvé: <a href=salut.html>clique moi</?> -partie 1: <a href=salut.html> +partie 3: </B> +trouvé: <a href=salut.html>clique moi</a> +partie 1: <a href=salut.html> partie 2: clique moi -partie 3: </?> +partie 3: </a> +]]> </computeroutput> </para> <simpara> Voir aussi <function>preg_match</function>, - <function>preg_replace</function> - et <function>preg_split</function>. + <function>preg_replace</function> et + <function>preg_split</function>. </simpara> </refsect1> </refentry> Index: phpdoc-fr/reference/zlib/functions/gzdeflate.xml diff -u phpdoc-fr/reference/zlib/functions/gzdeflate.xml:1.3 phpdoc-fr/reference/zlib/functions/gzdeflate.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzdeflate.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzdeflate.xml Mon Oct 14 18:38:28 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.11 --> <refentry id="function.gzdeflate"> <refnamediv> @@ -31,7 +31,7 @@ Voir aussi <function>gzinflate</function>, <function>gzcompress</function>, - <function>gzuncompress</function>, + <function>gzuncompress</function> et <function>gzencode</function>. </para> </refsect1> Index: phpdoc-fr/reference/zlib/functions/gzencode.xml diff -u phpdoc-fr/reference/zlib/functions/gzencode.xml:1.3 phpdoc-fr/reference/zlib/functions/gzencode.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzencode.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzencode.xml Mon Oct 14 18:38:29 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.4 --> <refentry id="function.gzencode"> <refnamediv> @@ -65,8 +65,8 @@ </para> <para> Voir aussi - <function>gzcompress</function>. - <function>gzuncompress</function>, + <function>gzcompress</function> + <function>gzuncompress,</function> <function>gzdeflate</function> et <function>gzinflate</function>. </para> Index: phpdoc-fr/reference/zlib/functions/gzgetc.xml diff -u phpdoc-fr/reference/zlib/functions/gzgetc.xml:1.3 phpdoc-fr/reference/zlib/functions/gzgetc.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzgetc.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzgetc.xml Mon Oct 14 18:38:29 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.gzgetc"> <refnamediv> @@ -14,7 +14,8 @@ </methodsynopsis> <para> <function>gzgetc</function> retourne une chaîne contenant un - caractère unique (décompressé), lu dans le fichier représenté par + caractère unique (décompressé), lu dans le + fichier représenté par <parameter>zp</parameter>. <function>gzgetc</function> retourne &false; si la fin du fichier est atteinte (tout comme <function>gzeof</function>). Index: phpdoc-fr/reference/zlib/functions/gzgetss.xml diff -u phpdoc-fr/reference/zlib/functions/gzgetss.xml:1.3 phpdoc-fr/reference/zlib/functions/gzgetss.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzgetss.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzgetss.xml Mon Oct 14 18:38:30 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.gzgetss"> <refnamediv> @@ -26,7 +26,8 @@ souhaitez conserver. <note> <para> - <parameter>Allowable_tags</parameter> a été ajouté en PHP 3.0.13, et PHP 4.0b3. + <parameter>Allowable_tags</parameter> a été + ajouté en PHP 3.0.13, et PHP 4.0b3. </para> </note> </para> Index: phpdoc-fr/reference/zlib/functions/gzpassthru.xml diff -u phpdoc-fr/reference/zlib/functions/gzpassthru.xml:1.3 phpdoc-fr/reference/zlib/functions/gzpassthru.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzpassthru.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzpassthru.xml Mon Oct 14 18:38:30 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.gzpassthru"> <refnamediv> @@ -27,7 +27,8 @@ </para> <para> Le fichier est alors fermé lorsque <function>gzpassthru</function> - a terminé sa lecture. <parameter>zp</parameter> n'est plus utilisable. + a terminé sa lecture. <parameter>zp</parameter> n'est plus utilisable + après. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/zlib/functions/gzread.xml diff -u phpdoc-fr/reference/zlib/functions/gzread.xml:1.3 phpdoc-fr/reference/zlib/functions/gzread.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzread.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzread.xml Mon Oct 14 18:38:31 2002 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.gzread"> <refnamediv> <refname>gzread</refname> - <refpurpose>Binary-safe gz-file read</refpurpose> + <refpurpose>Lecture de fichier compressé binaire</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -24,19 +24,25 @@ <informalexample> <programlisting role="php"> <![CDATA[ -// get contents of a gz-file into a string -$filename = "/usr/local/something.txt.gz"; -$zd = gzopen ($filename, "r"); -$contents = gzread ($zd, 10000); -gzclose ($zd); +<?php +// Lit le contenu d'un fichier dans une chaîne + $filename = "/usr/local/something.txt.gz"; + $zd = gzopen($filename, "r"); + $contents = gzread($zd, 10000); + gzclose($zd); +?> ]]> </programlisting> </informalexample> </para> <simpara> - See also <function>gzwrite</function>, <function>gzopen</function>, - <function>gzgets</function>, <function>gzgetss</function>, - <function>gzfile</function>, and <function>gzpassthru</function>. + Voir aussi + <function>gzwrite</function>, + <function>gzopen</function>, + <function>gzgets</function>, + <function>gzgetss</function>, + <function>gzfile</function> et + <function>gzpassthru</function>. </simpara> </refsect1> </refentry> Index: phpdoc-fr/reference/zlib/functions/gzwrite.xml diff -u phpdoc-fr/reference/zlib/functions/gzwrite.xml:1.3 phpdoc-fr/reference/zlib/functions/gzwrite.xml:1.4 --- phpdoc-fr/reference/zlib/functions/gzwrite.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/gzwrite.xml Mon Oct 14 18:38:31 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.gzwrite"> <refnamediv> @@ -20,8 +20,8 @@ <parameter>zp</parameter>. SI le paramètre <parameter>length</parameter> est fourni, l'écriture s'arrêtera lorsque <parameter>length</parameter> octets décompressés - on été écrit, ou à la fin de la chaîne <parameter>string</parameter> : - le premier qui arrive. + on été écrit, ou à la fin de la chaîne + <parameter>string</parameter> : le premier qui arrive. </simpara> <simpara> Notez que si <parameter>length</parameter> est donné, et que Index: phpdoc-fr/reference/zlib/functions/readgzfile.xml diff -u phpdoc-fr/reference/zlib/functions/readgzfile.xml:1.3 phpdoc-fr/reference/zlib/functions/readgzfile.xml:1.4 --- phpdoc-fr/reference/zlib/functions/readgzfile.xml:1.3 Fri Sep 6 03:10:10 2002 +++ phpdoc-fr/reference/zlib/functions/readgzfile.xml Mon Oct 14 18:38:31 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.readgzfile"> <refnamediv> @@ -31,17 +31,19 @@ appelée avec <literal>@readgzfile</literal>. </para> <para> - The file <parameter>filename</parameter> will be opened from the - filesystem and its contents written to standard output. + Le fichier <parameter>filename</parameter> sera ouvert dans le + systme de fichier, et son contenu sera affiché. </para> <para> - You can use the optional second parameter and set it to "1", if - you want to search for the file in the <link - linkend="ini.include-path">include_path</link>, too. + Vous pouvez utiliser le troisième paramètre optionnel en lui donnant la valeur + de <literal>1</literal>, si vous voulez rechercher le fichier dans + l'<link linkend="ini.include-path">include_path</link>. </para> <para> - See also <function>gzpassthru</function>, - <function>gzfile</function>, and <function>gzopen</function>. + Voir aussi + <function>gzpassthru</function>, + <function>gzfile,</function> et + <function>gzopen</function>. </para> </refsect1> </refentry>