dams Fri Jan 26 06:43:31 2001 EDT
Modified files:
/phpdoc/fr/functions datetime.xml session.xml sockets.xml
strings.xml zlib.xml array.xml
Log:
Few updates.
Some misspelling.
Index: phpdoc/fr/functions/datetime.xml
diff -u phpdoc/fr/functions/datetime.xml:1.9 phpdoc/fr/functions/datetime.xml:1.10
--- phpdoc/fr/functions/datetime.xml:1.9 Tue Jan 23 02:51:52 2001
+++ phpdoc/fr/functions/datetime.xml Fri Jan 26 06:43:31 2001
@@ -85,7 +85,7 @@
</listitem>
<listitem>
<simpara>
- d - Jour du mois, sur deux chiffres (éventuellement avec un
zéros) :
+ d - Jour du mois, sur deux chiffres (éventuellement avec un
+zéro) :
"01" à "31"
</simpara>
</listitem>
@@ -899,8 +899,8 @@
</itemizedlist>
<note>
<para>
- Tous les caract�res suivants ne sont pas toujours support�s par
- toutes les librairies C. Dans ce cas, ils ne seront pas support�s
+ Tous les caractères suivants ne sont pas toujours supportés par
+ toutes les librairies C. Dans ce cas, ils ne seront pas supportés
par PHP non plus.
</para>
</note>
Index: phpdoc/fr/functions/session.xml
diff -u phpdoc/fr/functions/session.xml:1.6 phpdoc/fr/functions/session.xml:1.7
--- phpdoc/fr/functions/session.xml:1.6 Tue Jan 23 02:48:27 2001
+++ phpdoc/fr/functions/session.xml Fri Jan 26 06:43:31 2001
@@ -41,8 +41,8 @@
</para>
<note>
<para>
- Depuis PHP 4.0.3, <link
- linkend="ini.track-vars"><literal>track_vars</literal></link> est toujours
+ Depuis PHP 4.0.3,
+ <link linkend="ini.track-vars"><literal>track_vars</literal></link> est toujours
activée.
</para>
</note>
@@ -126,6 +126,15 @@
<literal>session_name=session_id</literal>, ou bien, c'est
une chaîne vide.
</para>
+ <note>
+ <para>
+ La fonction qui gérera l'écriture des données ne sera
+appelée
+ qu'une fois le script aura envoyé toutes ses données. Ainsi,
+ les affichages tentés par cette fonction ne pourront jamais
+ être recus par le navigateur. Si un tel affichage est nécessaire,
+ il est conseillé d'écrire les debugs dans un fichier.
+ </para>
+ </note>
<para>
L'exemple suivant montre comment enregistrer une variable, et comment relier
correctement des pages avec SID.
@@ -141,8 +150,8 @@
# le <?=SID> est nécessaire pour transmettre l'identifiant de session
# au cas oú les utilisateurs auraient inactivé les cookies
?>
-Pour continuer, <A HREF="nextpage.php?<?=SID"?>clique ici</?>
</programlisting>
+ Pour continuer, <A HREF="nextpage.php?<?=SID"?>clique ici</?>
</example>
</para>
<para>
@@ -181,7 +190,7 @@
<warning>
<para>
Si le dossier que vous utilisez a les droits de lecture universels,
- comme <filename>/tmp</filename> (valeur par d�faut), les autres utilisateurs
+ comme <filename>/tmp</filename> (valeur par défaut), les autres
+utilisateurs
du serveur peuvent aussi lire ces fichiers, et s'imiscer dans vos sessions.
</para>
</warning>
@@ -322,11 +331,11 @@
session passé par une variable GET ou par un cookie)
</simpara>
<simpara>
- Cette fonction retourne toujours <literal>TRUE</literal>.
+ <function>session_start</function> retourne toujours <literal>TRUE</literal>.
</simpara>
<note>
<para>
- Cette fonction a été ajoutée dans PHP 4.0.
+ <function>session_start</function> a été ajoutée en
+PHP 4.0.
</para>
</note>
</refsect1>
@@ -351,7 +360,8 @@
données associées à la session courante.
</simpara>
<simpara>
- Cette fonction retourne <literal>TRUE</literal> en cas de succès, et
<literal>FALSE</literal> sinon.
+ <function>session_destroy</function> retourne <literal>TRUE</literal> en
+ cas de succès, et <literal>FALSE</literal> sinon.
</simpara>
</refsect1>
</refentry>
@@ -397,7 +407,8 @@
</example>
<note>
<para>
- Cette fonction a été ajoutée dans PHP 4.0.
+ <function>session_name</function> a été ajoutée
+ en PHP 4.0.
</para>
</note>
</refsect1>
@@ -423,7 +434,8 @@
est fourni, ce module sera utilisé à la place du courant.
<note>
<para>
- Cette fonction a été ajoutée dans PHP 4.0.
+ <function>session_module_name</function> a été ajoutée
+ en PHP 4.0.
</para>
</note>
</para>
@@ -460,7 +472,8 @@
</note>
<note>
<para>
- Cette fonction a été ajoutée dans PHP 4.0.
+ <function>session_save_path</function> a été ajoutée
+ en PHP 4.0.
</para>
</note>
</para>
@@ -490,7 +503,8 @@
son identifiant, comme chaîne à ajouter dans les URL.
<note>
<para>
- Cette fonction a été ajoutée dans PHP 4.0.
+ <function>session_id</function> a été ajoutée
+ en PHP 4.0.
</para>
</note>
</para>
@@ -521,11 +535,12 @@
des chaînes ou d'autre tableau (récursif).
</para>
<para>
- Cette fonction retourne <literal>TRUE</literal> lorsque la variable est
correctement
- enregistrée.
+ <function>session_register</function> retourne <literal>TRUE</literal> lorsque
+ la variable est correctement enregistrée.
<note>
<para>
- Cette fonction a été ajoutée dans PHP 4.0.
+ <function>session_register</function> a été ajoutée
+ en PHP 4.0.
</para>
</note>
</para>
@@ -551,12 +566,13 @@
nommée <parameter>name</parameter> dans la session courante.
</para>
<para>
- <function>session_unregister</function> retourne <literal>TRUE</literal> (vrai)
+ <function>session_unregister</function> retourne <literal>TRUE</literal>
lorsque la variable a été correctement supprimée
de la session.
<note>
<para>
- Cette fonction a été ajoutée dans PHP 4.0.
+ <function>session_unregister</function> a été ajoutée
+ en PHP 4.0.
</para>
</note>
</para>
@@ -599,12 +615,13 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>session_is_registered</function> retourne <literal>TRUE</literal> si
il y
- a une variable du nom de <parameter>name</parameter>
+ <function>session_is_registered</function> retourne <literal>TRUE</literal>
+ s'il y a une variable du nom de <parameter>name</parameter>
enregistrée dans la session courante.
<note>
<para>
- Cette fonction a été ajoutée dans PHP 4.0.
+ <function>session_is_registered</function> a été
+ajoutée
+ en PHP 4.0.
</para>
</note>
</para>
@@ -703,7 +720,8 @@
et affecte les valeurs des variables de session.
<note>
<para>
- Cette fonction a été ajoutée dans PHP 4.0.
+ <function>session_decode</function> a été ajoutée
+ en PHP 4.0.
</para>
</note>
</para>
@@ -727,7 +745,8 @@
session dans une chaîne.
<note>
<para>
- Cette fonction a été ajoutée dans PHP 4.0.
+ <function>session_encode</function> a été ajoutée
+ en PHP 4.0.
</para>
</note>
</para>
Index: phpdoc/fr/functions/sockets.xml
diff -u phpdoc/fr/functions/sockets.xml:1.4 phpdoc/fr/functions/sockets.xml:1.5
--- phpdoc/fr/functions/sockets.xml:1.4 Mon Jan 22 03:58:33 2001
+++ phpdoc/fr/functions/sockets.xml Fri Jan 26 06:43:31 2001
@@ -8,6 +8,12 @@
un serveur aussi bien qu'un client.
</simpara>
<para>
+ Les fonctions socket décrites ici sont rassemblées dans une
+extension
+ PHP. Pour être activées, il faut utiliser l'option de compilation
+ <option role="configure">--enable-sockets</option> au script
+ <command>configure</command>.
+ </para>
+ <para>
Pour une interface client plus générique, reportez vous à
<function>fsockopen</function> et <function>pfsockopen</function>.
</para>
Index: phpdoc/fr/functions/strings.xml
diff -u phpdoc/fr/functions/strings.xml:1.19 phpdoc/fr/functions/strings.xml:1.20
--- phpdoc/fr/functions/strings.xml:1.19 Tue Jan 23 02:48:27 2001
+++ phpdoc/fr/functions/strings.xml Fri Jan 26 06:43:31 2001
@@ -2951,7 +2951,7 @@
<funcdef>mixed <function>str_replace</function></funcdef>
<paramdef>mixed <parameter>search</parameter></paramdef>
<paramdef>mixed <parameter>replace</parameter></paramdef>
- <paramdef>mixed <parameter>subject</parameter></paramdef>
+ <paramdef>mixed <parameter>subject</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -2962,23 +2962,23 @@
utiliser <function>ereg_replace</function>.
</para>
<para>
- En PHP 4.0.5 et plus r�cent, chaque param�tre de
- <function>str_replace</function> peut �tre un tableau.
+ En PHP 4.0.5 et plus récent, chaque paramètre de
+ <function>str_replace</function> peut être un tableau.
</para>
<para>
- Si <parameter>subject</parameter> est un tableau, alors le remplacement
- est effectu� pour chaque valeur de <parameter>subject</parameter>, et la
- valeur retourn� sera un tableau.
+ Si <parameter>subject</parameter> est un tableau, alors le remplacement
+ est effectué pour chaque valeur de <parameter>subject</parameter>, et la
+ valeur retourné sera un tableau.
</para>
<para>
Si <parameter>search</parameter> et <parameter>replace</parameter> sont
des tableaux, alors <function>str_replace</function> prend une valeur dans
- chaque tableau, et s'en sert pour chercher et remplacer dans
+ chaque tableau, et s'en sert pour chercher et remplacer dans
<parameter>subject</parameter>. Si <parameter>replace</parameter> a moins
- de valeurs que <parameter>search</parameter>, des cha�nes vides seront utilis�es
- pour compl�ter le tableau <parameter>replace</parameter> . Si
- <parameter>search</parameter> est un tableau et <parameter>replace</parameter>
- est une cha�ne, alors la m�me cha�ne de remplacement sera utilis�e pour chaque
+ de valeurs que <parameter>search</parameter>, des chaînes vides seront
+utilisées
+ pour compléter le tableau <parameter>replace</parameter> . Si
+ <parameter>search</parameter> est un tableau et <parameter>replace</parameter>
+ est une chaîne, alors la même chaîne de remplacement sera
+utilisée pour chaque
valeur de <parameter>search</parameter>. Le contraire n'aurait pas beaucoup de
sens.
</para>
Index: phpdoc/fr/functions/zlib.xml
diff -u phpdoc/fr/functions/zlib.xml:1.5 phpdoc/fr/functions/zlib.xml:1.6
--- phpdoc/fr/functions/zlib.xml:1.5 Tue Jan 23 02:48:27 2001
+++ phpdoc/fr/functions/zlib.xml Fri Jan 26 06:43:31 2001
@@ -68,7 +68,7 @@
<function>gzclose</function> ferme le pointeur <parameter>zp</parameter>.
</para>
<para>
- <function>gzclose</function> retourne <literal>TRUE</literal> ou
+ <function>gzclose</function> retourne <literal>TRUE</literal> ou
<literal>FALSE</literal>, suivant le succès ou l'échec.
</para>
<para>
@@ -208,7 +208,7 @@
<paramdef>string
<parameter><optional>allowable_tags</optional></parameter></paramdef>
</funcsynopsis>
<para>
- <function>gzgetss</function> est identique à <function>gzgets</function>,
+ <function>gzgetss</function> est identique à <function>gzgets</function>,
mais elle essaie de supprimer toutes les balises HTML et PHP du texte lu.
</para>
<para>
@@ -241,8 +241,8 @@
<paramdef>int
<parameter><optional>use_include_path</optional></parameter></paramdef>
</funcsynopsis>
<para>
- <function>gzopen</function> ouvre un fichier compressé avec gzip (.gz)
- pour le lire ou l'écrire. Le paramètre de mode est le même
+ <function>gzopen</function> ouvre un fichier compressé avec gzip (.gz)
+ pour le lire ou l'écrire. Le paramètre de mode est le même
que dans <function>fopen</function> ("rb" ou "wb") mais il peut aussi inclure
un niveau de compression ("wb9") ou une stratégie: 'f' pour
les données filtrées, comme dans "wb6f", 'h' pour
@@ -419,8 +419,8 @@
<paramdef>int <parameter>offset</parameter></paramdef>
</funcsynopsis>
<para>
- <function>gzseek</function> positionne le pointeur interne du fichier
- compressé <parameter>zp</parameter> à la position donnée
+ <function>gzseek</function> positionne le pointeur interne du fichier
+ compressé <parameter>zp</parameter> à la position donnée
en <parameter>offset</parameter>. Equivalent à l'appel (en C) de
<literal>gzseek(zp, offset, SEEK_SET)</literal>.
</para>
@@ -432,8 +432,8 @@
séquence de zéro jusqu'à la nouvelle position.
</para>
<para>
- <function>gzseek</function> retourne 0 en cas de succès, sinon
- retourne -1. Notez que positionner le pointeur au delà de la
+ <function>gzseek</function> retourne 0 en cas de succès, sinon
+ retourne -1. Notez que positionner le pointeur au delà de la
fin du fichier est une erreur.
</para>
<para>
@@ -519,7 +519,7 @@
<paramdef>int
<parameter><optional>use_include_path</optional></parameter></paramdef>
</funcsynopsis>
<para>
- <function>readgzfile</function> lit un fichier, le décompresse et
+ <function>readgzfile</function> lit un fichier, le décompresse et
l'écrit dans la sortie standard.
</para>
<para>
@@ -528,9 +528,9 @@
décompression est omise, et le fichier est directement affiché.
</para>
<para>
- <function>readgzfile</function> retourne le nombre d'octets (non
compressé)
- lus depuis le fichier. Si une erreur survient, retourne
<literal>FALSE</literal>,
- et à moins que la fonction n'ai été appelée avec
+ <function>readgzfile</function> retourne le nombre d'octets (non
+compressé)
+ lus depuis le fichier. Si une erreur survient, retourne
+<literal>FALSE</literal>,
+ et à moins que la fonction n'ai été appelée avec
@readgzfile, l'erreur est affichée.
</para>
<para>
@@ -565,10 +565,10 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>gzcompress</function> retourne la version compressé GZ de
- la chaîne <parameter>data</parameter>, ou <literal>FALSE</literal>
- en cas d'erreur. Le paramètre <parameter>level</parameter> peut
- prendre des valeurs depuis 0 (pas de compression) jusqu'à 9
+ <function>gzcompress</function> retourne la version compressé GZ de
+ la chaîne <parameter>data</parameter>, ou <literal>FALSE</literal>
+ en cas d'erreur. Le paramètre <parameter>level</parameter> peut
+ prendre des valeurs depuis 0 (pas de compression) jusqu'à 9
(compression maximum).
</para>
<para>
@@ -596,7 +596,7 @@
<function>gzuncompress</function> prend la chaîne
<parameter>data</parameter> en entrée (compressée par
<function>gzcompress</function>) et retourne la chaîne originale,
- ou bien <literal>FALSE</literal> en cas d'erreur.
<function>gzuncompress</function>
+ ou bien <literal>FALSE</literal> en cas d'erreur.
+<function>gzuncompress</function>
retournera une erreur si la taille de la chaîne décompressée
est plus de 256 fois la longueur de la chaîne compressée
<parameter>data</parameter> ou plus que le paramètre optionnel
@@ -604,8 +604,8 @@
</para>
<note>
<para>
- Ceci <emphasis>n'est pas �quivalent</emphasis> � une comrpession gzip,
- qui inclus en plus des donn�es d'ent�te. Voir <function>gzencode</function>
+ Ceci <emphasis>n'est pas équivalent</emphasis> à une comrpession
+gzip,
+ qui inclus en plus des données d'entête. Voir
+<function>gzencode</function>
pour la compression gzip.
</para>
</note>
Index: phpdoc/fr/functions/array.xml
diff -u phpdoc/fr/functions/array.xml:1.18 phpdoc/fr/functions/array.xml:1.19
--- phpdoc/fr/functions/array.xml:1.18 Tue Jan 23 02:51:52 2001
+++ phpdoc/fr/functions/array.xml Fri Jan 26 06:43:31 2001
@@ -322,7 +322,7 @@
<para>
Si l'option <parameter>search_value</parameter> est spécifiée,
seules les clés ayant cette valeur seront retournées.
- Sinon, toutes les clés de <parameter>input</parameter> sont
+ Sinon, toutes les clés de <parameter>input</parameter> sont
retournées.
</para>
<para>
@@ -331,17 +331,15 @@
<programlisting role="php">
<?php
$array = array(0 => 100, "couleur" => "rouge");
-array_keys($array);
+array_keys($array);
// retourne array(0, "couleur")
-
$array = array("bleu", "rouge", "vert", "bleu", "bleu");
-array_keys($array, "bleu");
-// retourne array(0, 3, 4)
-
-$array = array( "couleur" => array("bleu", "rouge", "vert"),
+array_keys($array, "bleu");
+// retourne array(0, 3, 4)
+$array = array( "couleur" => array("bleu", "rouge", "vert"),
"taille" => array("petit", "moyen", "grand") );
-array_keys($array);
-// retourne array("couleur", "taille")
+array_keys($array);
+// retourne array("couleur", "taille")
?>
</programlisting>
</example>
@@ -767,7 +765,7 @@
<funcprototype>
<funcdef>array <function>array_reverse</function></funcdef>
<paramdef>array <parameter>array</parameter></paramdef>
- <paramdef>bool
+ <paramdef>bool
<parameter><optional>preserve_keys</optional></parameter>
</paramdef>
</funcprototype>
@@ -775,7 +773,7 @@
<para>
<function>array_reverse</function> prend le tableau <parameter>array</parameter>
et retourne un nouveau tableau qui contient les mêmes
éléments
- mais dans l'ordre inverse, en pr�servant les cl�s si le param�tre
+ mais dans l'ordre inverse, en préservant les clés si le
+paramètre
<parameter>preserve_keys</parameter> vaut <literal>TRUE</literal>.
</para>
<para>
@@ -798,7 +796,7 @@
</note>
<note>
<para>
- Le second param�tre <parameter>preserve_keys</parameter> a �t� �jout� en PHP
4.0.3.
+ Le second paramètre <parameter>preserve_keys</parameter> a
+été éjouté en PHP 4.0.3.
</para>
</note>
</para>
@@ -1488,9 +1486,9 @@
<title>Exemple avec <function>count</function></title>
<programlisting role="php">
<?php
-$a[0] = 1;
-$a[1] = 3;
-$a[2] = 5;
+$a[0] = 1;
+$a[1] = 3;
+$a[2] = 5;
$result = count ($a);
//$result == 3
?>
@@ -1689,11 +1687,11 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>extract</function> sert à exporter un tableau vers
- la table des symboles. Elle prend un tableau associatif
- <parameter>var_array</parameter> et crée les variables dont les
- noms sont les index de ce tableau, et leur affecte la valeur associée.
- Pour chaque paire clé/valeur, <function>extract</function> crée
+ <function>extract</function> sert à exporter un tableau vers
+ la table des symboles. Elle prend un tableau associatif
+ <parameter>var_array</parameter> et crée les variables dont les
+ noms sont les index de ce tableau, et leur affecte la valeur associée.
+ Pour chaque paire clé/valeur, <function>extract</function> crée
une variable, avec les paramètres <parameter>extract_type</parameter>
et <parameter>prefix</parameter>.
</para>
@@ -1747,8 +1745,8 @@
<term>EXTR_PREFIX_INVALID</term>
<listitem>
<simpara>
- Pr�fixer uniquement les variables aux noms invalides ou num�riques
- avec le pr�fixe <parameter>prefix</parameter>. Ceci a �t� ajout�
+ Préfixer uniquement les variables aux noms invalides ou
+numériques
+ avec le préfixe <parameter>prefix</parameter>. Ceci a
+été ajouté
en PHP 4.0.5.
</simpara>
</listitem>
@@ -1756,19 +1754,19 @@
</variablelist>
</para>
<para>
- Si <parameter>extract_type</parameter> est omis, <function>extract</function>
+ Si <parameter>extract_type</parameter> est omis, <function>extract</function>
utilise EXTR_OVERWRITE par défault.
</para>
<para>
Notez que <parameter>prefix</parameter> n'est nécessaire que pour
les valeurs de <parameter>extract_type</parameter> suivantes :
- EXTR_PREFIX_SAME, EXTR_PREFIX_ALL ou EXTR_PREFIX_INVALID. Le r�sultat
- pr�fix� n'est pas un nom de variable valide, il ne sera pas import� dans
+ EXTR_PREFIX_SAME, EXTR_PREFIX_ALL ou EXTR_PREFIX_INVALID. Le résultat
+ préfixé n'est pas un nom de variable valide, il ne sera pas
+importé dans
la table des symboles.
</para>
<para>
- <function>extract</function> retourne le nombre de variables r��llement
- import�es dans la table des symbols.
+ <function>extract</function> retourne le nombre de variables
+rééllement
+ importées dans la table des symbols.
</para>
<para>
Une utilisation possible de <function>extract</function> est l'exportation
