dams Tue Mar 27 03:02:15 2001 EDT
Modified files:
/phpdoc/fr/functions info.xml regex.xml strings.xml filesystem.xml
Log:
Latest updates.
Index: phpdoc/fr/functions/info.xml
diff -u phpdoc/fr/functions/info.xml:1.13 phpdoc/fr/functions/info.xml:1.14
--- phpdoc/fr/functions/info.xml:1.13 Mon Mar 19 09:01:14 2001
+++ phpdoc/fr/functions/info.xml Tue Mar 27 03:02:14 2001
@@ -1500,12 +1500,12 @@
<title>Affichage des fichirs inclus et requis</title>
<programlisting>
<?php
-require_once ("local.php");
-require_once ("../inc/global.php");
+require_once("local.php");
+require_once("../inc/global.php");
for ($i=1; $i<5; $i++)
- include "util".$i."php";
+ include "util".$i.".php";
echo "Fichiers appelés avec required_once/included_once\n";
- print_r (get_required_files());
+ print_r(get_required_files());
?>
</programlisting>
</example>
Index: phpdoc/fr/functions/regex.xml
diff -u phpdoc/fr/functions/regex.xml:1.9 phpdoc/fr/functions/regex.xml:1.10
--- phpdoc/fr/functions/regex.xml:1.9 Mon Mar 12 04:14:00 2001
+++ phpdoc/fr/functions/regex.xml Tue Mar 27 03:02:14 2001
@@ -183,7 +183,7 @@
<parameter>string</parameter> sera retournée intacte.
</para>
<para>
- Par exemple, le code suivant affiche "Ceci est un test" trois fois :
+ Par exemple, le code suivant affiche "Ceci etait un test" trois fois :
<example>
<title>Exemple avec <function>ereg_replace</function></title>
<programlisting role="php">
Index: phpdoc/fr/functions/strings.xml
diff -u phpdoc/fr/functions/strings.xml:1.35 phpdoc/fr/functions/strings.xml:1.36
--- phpdoc/fr/functions/strings.xml:1.35 Wed Mar 21 03:04:23 2001
+++ phpdoc/fr/functions/strings.xml Tue Mar 27 03:02:14 2001
@@ -2049,7 +2049,7 @@
<refnamediv>
<refname>strchr</refname>
<refpurpose>
- Recherche la première occurrence d'un caractère.
+ Renvoie la chaîne à partir de la première occurence
</refpurpose>
</refnamediv>
<refsect1>
@@ -2602,12 +2602,12 @@
<programlisting role="php">
<?php
// PHP 4.0b3 et plus récent :
-$pos = strpos("b", $mystring);
+$pos = strpos($machaine, "b");
if ($pos === FALSE) { // note: trois signes égal
// non trouvé
}
// versions plus anciennes que 4.0b3:
-$pos = strpos("b", $mystring);
+$pos = strpos($machaine, "b");
if (is_string($pos) && !$pos) {
// non trouvé
}
@@ -2618,8 +2618,8 @@
</note>
</para>
<para>
- Si <parameter>needle</parameter> n'est pas une chaîne, elle est convertie
- en entier, et utilisée comme la valeur ASCII d'un caractère.
+ Si <parameter>needle</parameter> n'est pas une chaîne, elle est convertie
+ en entier, et utilisée comme la valeur ASCII d'un caractère.
</para>
<para>
L'argument optionnel <parameter>offset</parameter> permet de préciser
@@ -2845,12 +2845,14 @@
?>
</programlisting>
<para>
- affichera "2".
+ affichera "2", car "42" est la plus longue chaîne contenant
+ des chiffres dans la chaîne de question.
</para>
</informalexample>
</para>
<simpara>
- Voir aussi <function>strcspn</function>.
+ Voir aussi
+ <function>strcspn</function>.
</simpara>
</refsect1>
</refentry>
@@ -2858,7 +2860,8 @@
<refnamediv>
<refname>strstr</refname>
<refpurpose>
- Renvoie la chaîne à partir de la première
occurence</refpurpose>
+ Renvoie la chaîne à partir de la première occurence
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
Index: phpdoc/fr/functions/filesystem.xml
diff -u phpdoc/fr/functions/filesystem.xml:1.17 phpdoc/fr/functions/filesystem.xml:1.18
--- phpdoc/fr/functions/filesystem.xml:1.17 Mon Mar 19 09:01:14 2001
+++ phpdoc/fr/functions/filesystem.xml Tue Mar 27 03:02:14 2001
@@ -701,14 +701,15 @@
<parameter>filename</parameter> existe, et <literal>FALSE</literal> sinon.
</simpara>
<simpara>
- <function>file_exists</function> ne fonctionne pas sur les fichiers distants.
+ <function>file_exists</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
Les fichiers doivent être accessibles par le système de fichier
du serveur.
</simpara>
<simpara>
- Le résultat de <function>file_exists</function> est mis en cache.
- Reportez-vous à <function>clearstatcache</function> pour
- plus de détails.
+ Le résultat de <function>file_exists</function> est mis en cache.
+ Reportez-vous à <function>clearstatcache</function> pour
+ plus de détails.
</simpara>
</refsect1>
</refentry>
@@ -729,11 +730,17 @@
</funcprototype>
</funcsynopsis>
<simpara>
- <function>fileatime</function> renvoie la date à laquelle le fichier
- a été accédé pour la dernière fois, ou
- <literal>FALSE</literal> en cas d'erreur.
+ <function>fileatime</function> renvoie la date à laquelle le fichier
+ a été accédé pour la dernière fois, ou
+ <literal>FALSE</literal> en cas d'erreur.
</simpara>
<simpara>
+ <function>fileatime</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
+ <simpara>
Le résultat de <function>fileatime</function> est mis en cache.
Reportez vous à <function>clearstatcache</function> pour plus de
détails.
@@ -744,8 +751,8 @@
<refnamediv>
<refname>filectime</refname>
<refpurpose>
- Renvoie l'heure à laquelle l'inode a été
- accédé pour la dernière fois.
+ Renvoie l'heure à laquelle l'inode a été
+ accédé pour la dernière fois.
</refpurpose>
</refnamediv>
<refsect1>
@@ -757,14 +764,35 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>filectime</function> renvoie l'heure à laquelle l'inode
- <parameter>filename</parameter> a été accédé pour
- la dernière fois, ou <literal>FALSE</literal> en cas d'erreur.
+ <function>filectime</function> renvoie l'heure à laquelle l'inode
+ <parameter>filename</parameter> a été accédé pour
+ la dernière fois, ou <literal>FALSE</literal> en cas d'erreur.
</para>
+ <simpara>
+ <function>filectime</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
- Le résultat de <function>filectime</function> est mis en cache.
- Reportez vous à <function>clearstatcache</function> pour plus de
- détails.
+ Note: Sur la plus part des serveurs UNIX, un fichier est considéré
+ comme modifié si les données de sont inode sont modifiées.
+C'est à
+ dire lorsque les permissions (utilisateur, group ou autre) ont
+ été modifiées. Voyez aussi <function>filemtime</function>
+ (que vous pourrez utiliser lorsque vous créerez des indications
+ telles que "Dernière modification : " sur les pages web) et
+ <function>fileatime</function>.
+ </para>
+ <para>
+ Notea aussi que sur certains systèmes UNIX, le ctime d'un fichier
+ texte est considéré comme sa date de création. Cela est
+faux!
+ Il n'y a pas de date de création de fichier sous la plus part
+ des systèmes UNIX.
+ </para>
+ <para>
+ Le résultat de <function>filectime</function> est mis en cache.
+ Reportez vous à <function>clearstatcache</function> pour plus de
+ détails.
</para>
</refsect1>
</refentry>
@@ -783,10 +811,16 @@
</funcsynopsis>
<para>
<function>filegroup</function> renvoie le groupe qui possède le fichier
- <parameter>filename</parameter> ou <literal>FALSE</literal> en cas d'erreur.
L'identifiant de
- groupe est retourné au format numérique, utilisez
+ <parameter>filename</parameter> ou <literal>FALSE</literal> en cas d'erreur.
+ L'identifiant de groupe est retourné au format numérique, utilisez
<function>posix_getgrgid</function> pour retrouver le nom du groupe.
</para>
+ <simpara>
+ <function>filegroup</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
Le résultat de <function>filegroup</function> est mis en cache.
Reportez vous à <function>clearstatcache</function> pour plus de
@@ -821,6 +855,12 @@
Reportez vous à <function>clearstatcache</function> pour plus de
détails.
</para>
+ <simpara>
+ <function>fileinode</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<note>
<simpara>
<function>fileinode</function> est inopérante sous Windows.
@@ -853,6 +893,12 @@
Reportez vous à <function>clearstatcache</function> pour plus de
détails.
</para>
+ <simpara>
+ <function>filemtime</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
Note: <function>filemtime</function> retourne l'heure d'écriture
des blocs données d'un fichier. Utilisez <function>date</function>
@@ -875,11 +921,17 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>fileowner</function> renvoie le nom du possesseur du fichier
- <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur.
- L'identification du possesseur de fichier est numérique : il faut
utiliser
- <function>posix_getpwuid</function> pour retrouver le nom d'utilisateur.
+ <function>fileowner</function> renvoie le nom du possesseur du fichier
+ <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur.
+ L'identification du possesseur de fichier est numérique : il faut utiliser
+ <function>posix_getpwuid</function> pour retrouver le nom d'utilisateur.
</para>
+ <simpara>
+ <function>fileowner</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
Le résultat de <function>fileowner</function> est mis en cache.
Reportez vous à <function>clearstatcache</function> pour plus de
@@ -912,6 +964,12 @@
au fichier <parameter>filename</parameter>, ou <literal>FALSE</literal>
en cas d'erreur.
</para>
+ <simpara>
+ <function>fileperms</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
Le résultat de <function>fileperms</function> est mis en cache.
Reportez vous à <function>clearstatcache</function> pour plus de
@@ -936,6 +994,12 @@
<function>filesize</function> renvoie la taille du fichier
<parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur.
</para>
+ <simpara>
+ <function>filesize</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
Le résultat de <function>filesize</function> est mis en cache.
Reportez vous à <function>clearstatcache</function> pour plus
@@ -957,13 +1021,19 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>filetype</function> renvoie le type du fichier
- <parameter>filename</parameter>. Les réponses possibles sont :
- fifo, char, dir, block, link, file, et unknown.
+ <function>filetype</function> renvoie le type du fichier
+ <parameter>filename</parameter>. Les réponses possibles sont :
+ fifo, char, dir, block, link, file, et unknown.
</para>
<para>
- <function>filetype</function> retourne <literal>FALSE</literal> en cas d'erreur.
+ <function>filetype</function> retourne <literal>FALSE</literal> en cas d'erreur.
</para>
+ <simpara>
+ <function>filetype</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
Le résultat de <function>filetype</function> est mis en cache.
Reportez vous à <function>clearstatcache</function> pour plus de
@@ -986,9 +1056,9 @@
</funcprototype>
</funcsynopsis>
<simpara>
- PHP dispose d'un système complet de verrouillage de fichiers.
- Tous les programmes qui accèdent au fichier doivent utiliser la
- même méthode de verrouillage pour qu'il soit efficace.
+ PHP dispose d'un système complet de verrouillage de fichiers.
+ Tous les programmes qui accèdent au fichier doivent utiliser la
+ même méthode de verrouillage pour qu'il soit efficace.
</simpara>
<simpara>
<function>flock</function> agit sur le fichier <parameter>fp</parameter>
@@ -1677,8 +1747,16 @@
Le résultat de <function>is_dir</function> est mis en cache. Voir la
fonction
<function>clearstatcache</function> pour plus de détails.
</para>
+ <simpara>
+ <function>is_dir</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
- Voir aussi <function>is_file</function> et <function>is_link</function>.
+ Voir aussi
+ <function>is_file</function> et
+ <function>is_link</function>.
</para>
</refsect1>
</refentry>
@@ -1696,16 +1774,24 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>is_executable</function> retourne <literal>TRUE</literal> si
- <parameter>filename</parameter> existe et est exécutable.
+ <function>is_executable</function> retourne <literal>TRUE</literal> si
+ <parameter>filename</parameter> existe et est exécutable.
</para>
<para>
- Le résultat de <function>is_executable</function> est mis en cache.
- Voir la fonction <function>clearstatcache</function> pour plus de
- détails.
+ Le résultat de <function>is_executable</function> est mis en cache.
+ Voir la fonction <function>clearstatcache</function> pour plus de
+ détails.
</para>
+ <simpara>
+ <function>is_executable</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
- Voir aussi <function>is_file</function> et <function>is_link</function>.
+ Voir aussi
+ <function>is_file</function> et
+ <function>is_link</function>.
</para>
</refsect1>
</refentry>
@@ -1725,17 +1811,25 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>is_file</function> retourne <literal>TRUE</literal> si
- <parameter>filename</parameter> existe et est un fichier
- (et pas un dossier).
+ <function>is_file</function> retourne <literal>TRUE</literal> si
+ <parameter>filename</parameter> existe et est un fichier
+ (et pas un dossier).
</para>
<para>
Le résultat de <function>is_file</function> est mis en cache.
Voir la fonction <function>clearstatcache</function> pour plus de
détails.
</para>
+ <simpara>
+ <function>is_file</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
- Voir aussi <function>is_dir</function> et <function>is_link</function>.
+ Voir aussi
+ <function>is_dir</function> et
+ <function>is_link</function>.
</para>
</refsect1>
</refentry>
@@ -1755,16 +1849,24 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>is_link</function> retourne <literal>TRUE</literal> si
- <parameter>filename</parameter> existe et est un lien symbolique.
+ <function>is_link</function> retourne <literal>TRUE</literal> si
+ <parameter>filename</parameter> existe et est un lien symbolique.
</para>
<para>
Le résultat de <function>is_link</function> est mis en cache.
Voir la fonction <function>clearstatcache</function> pour plus de
détails.
</para>
+ <simpara>
+ <function>is_link</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
- Voir aussi <function>is_dir</function> et <function>is_file</function>.
+ Voir aussi
+ <function>is_dir</function> et
+ <function>is_file</function>.
</para>
<note>
<simpara>
@@ -1800,8 +1902,15 @@
Voir la fonction <function>clearstatcache</function> pour plus de
détails.
</para>
+ <simpara>
+ <function>is_readable</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
- Voir aussi <function>is_writable</function>.
+ Voir aussi
+ <function>is_writable</function>.
</para>
</refsect1>
</refentry>
@@ -1827,13 +1936,20 @@
autorisations que l'utilisateur qui fait tourner le serveur web
(souvent, c'est 'nobody', personne).
</para>
+ <simpara>
+ <function>is_writable</function> ne fonctionne pas sur les
+ <link linkend="features.remote-files">fichiers distants</link>.
+ Les fichiers doivent être accessibles par le système de fichier
+ du serveur.
+ </simpara>
<para>
Le résultat de <function>is_writable</function> est mis en cache.
Voir la fonction <function>clearstatcache</function> pour plus de
détails.
</para>
<para>
- Voir aussi <function>is_readable</function>.
+ Voir aussi
+ <function>is_readable</function>.
</para>
</refsect1>
</refentry>
