Index: phpdoc/fr/functions/filesystem.xml diff -u phpdoc/fr/functions/filesystem.xml:1.6 phpdoc/fr/functions/filesystem.xml:1.7 --- phpdoc/fr/functions/filesystem.xml:1.6 Tue Nov 28 02:50:33 2000 +++ phpdoc/fr/functions/filesystem.xml Thu Dec 14 00:41:23 2000 @@ -138,7 +138,7 @@ Renvoie TRUE en cas de succès, "FALSE" sinon. - Sous Windows, ne fait rien et retourne TRUE. + Sous Windows, ne fait rien et retourne TRUE. @@ -147,7 +147,7 @@ - chown est inopérante sous Windows + chown est inopérante sous Windows. @@ -215,7 +215,7 @@ - copy fait une copie du fichier. Renvoie TRUE en + copy fait une copie du fichier. Elle renvoie TRUE en cas de succès, FALSE sinon. Exemple avec <function>copy</function> @@ -272,7 +272,7 @@ dirname retournera le nom du dossier qui le contient. - Sous Windows, les slash (/) et backslash + Sous Windows, les slash (/) et anti-slash (\) sont utilisés comme séparateurs de dossier. Dans les autres environnements, seul le slash (/) est utilisé. @@ -340,8 +340,9 @@ Retourne TRUE en cas de succès, et FALSE en cas d'échec. - Le pointeur de fichier doit être valide, et avoir été correctement ouvert par - fopen ou fsockopen. + Le pointeur de fichier doit être valide, et avoir été + correctement ouvert par fopen ou + fsockopen. @@ -359,8 +360,9 @@ - feof retourne TRUE si le pointeur fp - est à la fin du fichier, ou si une erreur survient, sinon, retourne FALSE. + feof retourne TRUE si le pointeur + fp est à la fin du fichier, ou si + une erreur survient, sinon, retourne FALSE. Le pointeur de fichier doit être valide, et avoir été @@ -385,10 +387,10 @@ - fflush forces l'écriture de toutes les données - bufferisées dans le fichier désigné par fp - (. - Retourne TRUE en cas de succès, et FALSE sinon. + fflush forces l'écriture de toutes les + données bufferisées dans le fichier désigné + par fp. Retourne TRUE en cas de succès, et + FALSE sinon. fp est un pointeur de fichier ouvert @@ -454,10 +456,10 @@ Identique à fgets mais fgetcsv - analyse la ligne qu'il lit et recherche les champs CSV, qu'il va retourner dans un - tableau les contenant. Le délimiteur de champs - delimiter est la virgule, - à moins que vous ne fournissiez un troisième argument. + analyse la ligne qu'il lit et recherche les champs CSV, qu'il + va retourner dans un tableau les contenant. Le délimiteur de champs + delimiter est la virgule, à moins que vous ne + fournissiez un troisième argument. fp doit être un pointeur valide, et avoir @@ -517,9 +519,10 @@ - fgets retourne la chaîne lue jusqu'à la longueur - length - 1 octets, ou bien la fin du fichier, ou encore - un retour chariot (le premier des trois qui sera rencontré). + fgets retourne la chaîne lue jusqu'à + la longueur length - 1 octets, ou bien la fin du + fichier, ou encore un retour chariot (le premier des trois qui sera + rencontré). Si une erreur survient, retourne FALSE. @@ -591,7 +594,7 @@ allowable_tags a été ajouté dans - PHP 3.0.13, PHP4B3. + PHP 3.0.13, PHP 4B3. @@ -636,8 +639,8 @@ <?php // Lire une page web dans un tableau, et l'afficher $fcontents = file( 'http://www.php.net' ); -while ( list( $line_num, $line ) = each( $fcontents ) ) { - echo "<b>Line $line_num:</b> " . htmlspecialchars( $line ) . "<br>\n"; +while ( list( $numero_ligne, $ligne ) = each( $fcontents ) ) { + echo "<b>Ligne $numero_ligne:</b> " . htmlspecialchars( $ligne ) . "<br>\n"; } // lire une page web dans une chaîne $fcontents = join( '', file( 'http://www.php.net' ) ); @@ -683,7 +686,8 @@ fileatime - Renvoie la date à laquelle le fichier a été accédé pour la dernière fois. + Renvoie la date à laquelle le fichier a été + accédé pour la dernière fois. @@ -700,8 +704,9 @@ FALSE en cas d'erreur. - Le résultat de fileatime est mis en cache. Reportez vous à - clearstatcache pour plus de détails. + Le résultat de fileatime est mis en cache. + Reportez vous à clearstatcache pour plus de + détails. @@ -709,8 +714,8 @@ filectime - 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. @@ -727,8 +732,9 @@ la dernière fois, ou FALSE en cas d'erreur. - Le résultat de filectime est mis en cache. Reportez vous à - clearstatcache pour plus de détails. + Le résultat de filectime est mis en cache. + Reportez vous à clearstatcache pour plus de + détails. @@ -747,17 +753,18 @@ filegroup renvoie le groupe qui possède le fichier - filename ou FALSE en cas d'erreur. - L'identifiant de groupe est retourné au format numérique, utilisez + filename ou FALSE en cas d'erreur. L'identifiant de + groupe est retourné au format numérique, utilisez posix_getgrgid pour retrouver le nom du groupe. - Le résultat de filegroup est mis en cache. Reportez vous à - clearstatcache pour plus de détails. + Le résultat de filegroup est mis en cache. + Reportez vous à clearstatcache pour plus de + détails. - filegroup est inopérante sous Windows + filegroup est inopérante sous Windows. @@ -780,12 +787,13 @@ filename, ou FALSE en cas d'erreur. - Le résultat de fileinode est mis en cache. Reportez vous à - clearstatcache pour plus de détails. + Le résultat de fileinode est mis en cache. + Reportez vous à clearstatcache pour plus de + détails. - fileinode est inopérante sous Windows + fileinode est inopérante sous Windows. @@ -793,7 +801,9 @@ filemtime - Renvoie la date de dernière modification du fichier. + + Renvoie la date de dernière modification du fichier. + Description @@ -804,17 +814,20 @@ - filemtime renvoie la date de dernière modification du - fichier filename, ou FALSE en cas d'erreur. + filemtime renvoie la date de dernière + modification du fichier filename, ou FALSE + en cas d'erreur. - Le résultat de filemtime est mis en cache. Reportez vous à - clearstatcache pour plus de détails. + Le résultat de filemtime est mis en cache. + Reportez vous à clearstatcache pour plus de + détails. - Note: filemtime retourne l'heure d'écriture des blocs - données d'un fichier. Utilisez date sur ce résultat - pour obtenir une date de modification lisible. + Note: filemtime retourne l'heure d'écriture + des blocs données d'un fichier. Utilisez date + sur ce résultat pour obtenir une date de modification humainement + lisible. @@ -833,17 +846,18 @@ fileowner renvoie le nom du possesseur du fichier - filename, ou FALSE en cas d'erreur. - L'identification du possesseur de fichier est numérique : il faut utiliser + filename, ou FALSE en cas d'erreur. L'identification + du possesseur de fichier est numérique : il faut utiliser posix_getpwuid pour retrouver le nom d'utilisateur. - Le résultat de fileowner est mis en cache. Reportez vous à - clearstatcache pour plus de détails. + Le résultat de fileowner est mis en cache. + Reportez vous à clearstatcache pour plus de + détails. - fileowner est inopérante sous Windows + fileowner est inopérante sous Windows. @@ -912,15 +926,17 @@ - filetype renvoie le type du fichier filename. - Les réponses possibles sont : fifo, char, dir, block, link, file, et unknown. + filetype renvoie le type du fichier + filename. Les réponses possibles sont : + fifo, char, dir, block, link, file, et unknown. Retourne FALSE en cas d'erreur. - Le résultat de filetype est mis en cache. Reportez vous à - clearstatcache pour plus de détails. + Le résultat de filetype est mis en cache. + Reportez vous à clearstatcache pour plus de + détails. @@ -981,7 +997,8 @@ n'importe quelle plateforme (Unix et Windows compris). - flock retourne TRUE en cas de succès, et FALSE sinon. (le verrou n'a pas pu être obtenu). + flock retourne TRUE en cas de succès, et FALSE + sinon. (le verrou n'a pas pu être obtenu). @@ -1027,9 +1044,9 @@ Si filename commence par "ftp://" (insensible à la casse), une connexion FTP est ouverte avec le serveur spécifié, et un pointeur sur la réponse fournie est retourné. Si le serveur - ne supporte par le mode FTP passif, fopen échouera. Vous pouvez - ouvrir des fichiers en lecture seulement, ou en écriture seulement (le - full duplex n'est pas supporté). + ne supporte par le mode FTP passif, fopen échouera. + Vous pouvez ouvrir des fichiers en lecture seulement, ou en écriture + seulement (le full duplex n'est pas supporté). Si filename commence par "php://stdin", "php://stdout", @@ -1117,7 +1134,7 @@ pas nécessairement accessibles au processus serveur. - Sous Windows, assurez vous de bien échapper les backslash + Sous Windows, assurez vous de bien échapper les anti-slash utilisés dans le chemin du fichier, ou bien utilisez des slash. @@ -1313,10 +1330,10 @@ fseek modifie le curseur de position dans le fichier fp. La nouvelle position - mesurée en octets à partir du début du fichier, est obtenue en - additionnant la distance offset à la position - whence. Ce paramètre peut prendre les - valeurs suivantes : + mesurée en octets à partir du début du fichier, + est obtenue en additionnant la distance offset + à la position whence. Ce paramètre + peut prendre les valeurs suivantes : SEEK_SET - La position finale vaut offset octets. @@ -1332,7 +1349,8 @@ - Si whence n'est pas spécifiée, il vaut par défaut SEEK_SET. + Si whence n'est pas spécifiée, il + vaut par défaut SEEK_SET. Retourne TRUE en cas de succès, et sinon -1. Notez que @@ -1366,9 +1384,9 @@ Rassemble les informations sur le fichier dont on connait le pointeur - fp. fstat est similaire à la fonction - stat, hormis le fait qu'elle utilise un pointeur de - fichier, au lieu d'un nom de fichier. + fp. fstat est similaire à + la fonction stat, hormis le fait qu'elle utilise un + pointeur de fichier, au lieu d'un nom de fichier. Retourne un tableau avec les éléments suivants : @@ -1428,9 +1446,7 @@ ftruncate - - Tronque une fichier - + Tronque une fichier. Description @@ -1579,11 +1595,13 @@ - Retourne TRUE si filename existe et est exécutable. + is_executable retourne TRUE si + filename existe et est exécutable. - Le résultat de is_executable est mis en cache. Voir la fonction - clearstatcache pour plus de détails. + Le résultat de is_executable est mis en cache. + Voir la fonction clearstatcache pour plus de + détails. Voir aussi is_file et is_link. @@ -1606,12 +1624,14 @@ - Retourne TRUE si filename existe et est un fichier + is_file retourne TRUE si + filename existe et est un fichier (et pas un dossier). - Le résultat de is_file est mis en cache. Voir la fonction - clearstatcache pour plus de détails. + Le résultat de is_file est mis en cache. + Voir la fonction clearstatcache pour plus de + détails. Voir aussi is_dir et is_link. @@ -1634,19 +1654,20 @@ - Retourne TRUE si filename existe et est un lien - symbolique. + is_link retourne TRUE si + filename existe et est un lien symbolique. - Le résultat de is_link est mis en cache. Voir la fonction - clearstatcache pour plus de détails. + Le résultat de is_link est mis en cache. + Voir la fonction clearstatcache pour plus de + détails. Voir aussi is_dir et is_file. - is_link est inopérante sous Windows + is_link est inopérante sous Windows. @@ -1654,9 +1675,7 @@ is_readable - - indique un fichier est autorisé en lecture - + Indique un fichier est autorisé en lecture Description @@ -1667,19 +1686,21 @@ - is_readable retourne vrai si filename - existe et est accessible en lecture. + is_readable retourne TRUE si + filename existe et est accessible en lecture. - N'oubliez pas que PHP accède aux fichiers avec les mêmes autorisations que - l'utilisateur qui fait tourner le serveur web (souvent, c'est 'nobody', personne). + N'oubliez pas que PHP accède aux fichiers avec les mêmes + autorisations que l'utilisateur qui fait tourner le serveur web + (souvent, c'est 'nobody', personne). - Le résultat de is_readable est mis en cache. Voir la fonction - clearstatcache pour plus de détails. + Le résultat de is_readable est mis en cache. + Voir la fonction clearstatcache pour plus de + détails. - Voir aussi is_writeable. + Voir aussi is_writeable. @@ -1697,16 +1718,18 @@ - is_writeable retourne TRUE si filename - existe et est accessible en lecture. + is_writeable retourne TRUE si + filename existe et est accessible en lecture. - N'oubliez pas que PHP accède aux fichiers avec les mêmes autorisations que - l'utilisateur qui fait tourner le serveur web (souvent, c'est 'nobody', personne). + N'oubliez pas que PHP accède aux fichiers avec les mêmes + autorisations que l'utilisateur qui fait tourner le serveur web + (souvent, c'est 'nobody', personne). - Le résultat de is_writeable est mis en cache. Voir la fonction - clearstatcache pour plus de détails. + Le résultat de is_writeable est mis en cache. + Voir la fonction clearstatcache pour plus de + détails. Voir aussi is_readable. @@ -1717,7 +1740,8 @@ is_uploaded_file - Indique si le fichier a été téléchargé par HTTP POST + Indique si le fichier a été téléchargé + par HTTP POST @@ -1733,11 +1757,11 @@ versions PHP 3.0.16 et 4.0.2. - Retourne TRUE si le fichier filename a été - téléchargé par HTTP POST. Cela est très utile - pour vous assurer qu'un utilisateur n'essaie pas d'accéder - intentionnellement à un fichier auquel il n'a pas droit - (comme /etc/passwd). + is_uploaded_file retourne TRUE si le fichier + filename a été téléchargé + par HTTP POST. Cela est très utile pour vous assurer qu'un + utilisateur n'essaie pas d'accéder intentionnellement à + un fichier auquel il n'a pas droit (comme /etc/passwd). Ce type de vérfication est spécialement important si il est @@ -1770,12 +1794,12 @@ link crée un lien. - Voir aussi symlink pour créer des liens symboliques et - et readlink avec linkinfo. + Voir aussi symlink pour créer des liens + symboliques et readlink avec linkinfo. - link est inopérante sous Windows + link est inopérante sous Windows. @@ -1807,7 +1831,7 @@ - linkinfo est inopérante sous Windows + linkinfo est inopérante sous Windows. @@ -1827,14 +1851,15 @@ - Tente de créer un dossier dans le chemin pathname. + mkdir tente de créer un dossier dans + le chemin pathname. - Notez que vous aurez à préciser le mode en base octale, ce qui signifie - que vous aurez probablement un 0 comme premier chiffre : + Notez que vous aurez à préciser le mode en base octale, + ce qui signifie que vous aurez probablement un 0 comme premier chiffre : -mkdir ("/path/to/my/dir", 0700); +mkdir ("/chemin/de/mon/dossier", 0700); @@ -2053,7 +2078,7 @@ - readlink est inopérante sous Windows + readlink est inopérante sous Windows. @@ -2215,15 +2240,16 @@ * - uniquement sur les systèmes qui supporte le type st_blksize type§les autres systèmes (i.e. Windows) retourne -1 - Les résultats de lstat sont mis en cache . Reportez vous à la fonction - clearstatcache pour plus de détails. + Les résultats de lstat sont mis en cache . + Reportez vous à la fonction clearstatcache + pour plus de détails. - + realpath - Retourne le chemin canonique absolu + Retourne le chemin canonique absolu. Description @@ -2234,7 +2260,7 @@ - realpath résoud tous les liens symbolique, et + realpath résoud tous les liens symboliques, et remplace toutes les références '/./', '/../' et '/' de path puis retourne le chemin canonique absolu ainsi trouvé. Le résultat ne contient aucun lien symbolique, @@ -2274,7 +2300,7 @@ - Csymlink est inopérante sous Windows + symlink est inopérante sous Windows. @@ -2343,8 +2369,9 @@ sera termniné. - Pour plus de détails, consultez votre documentation système sur la - fonction tmpfile(3), et sur stdio.h. + Pour plus de détails, consultez votre documentation système + sur la fonction tmpfile(3), et sur + stdio.h. Voir aussi tempnam. @@ -2381,10 +2408,10 @@ Exemple avec <function>touch</function> -if ( touch($FileName) ) { - print "$FileName modification time has been changed to todays date et time"; +if ( touch($NomDeFichier) ) { + print "La date de modification de $NomDeFichier a été fixée à maintenant"; } else { - print "Sorry Could Not change modification time of $FileName"; + print "Désolé, il est impossible de changer la date de modification de $NomDeFichier"; }