fgetcsv
<<<		 fgets fgetss
>>>
6.10 Système de fichiers
6 Référence des fonctions
 Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes pré-définies
. Voir aussi
. basename
. chgrp
. chmod
. chown
. clearstatcache
. copy
. delete
. dirname
. disk_free_space
. disk_total_space
. diskfreespace
. fclose
. feof
. fflush
. fgetc
. fgetcsv
->fgets
. fgetss
. file_exists
. file_get_contents
. file_put_contents
. file
. fileatime
. filectime
. filegroup
. fileinode
. filemtime
. fileowner
. fileperms
. filesize
. filetype
. flock
. fnmatch
. fopen
. fpassthru
. fputcsv
. fputs
. fread
. fscanf
. fseek
. fstat
. ftell
. ftruncate
. fwrite
. glob
. is_dir
. is_executable
. is_file
. is_link
. is_readable
. is_uploaded_file
. is_writable
. is_writeable
. link
. linkinfo
. lstat
. mkdir
. move_uploaded_file
. parse_ini_file
. pathinfo
. pclose
. popen
. readfile
. readlink
. realpath
. rename
. rewind
. rmdir
. set_file_buffer
. stat
. symlink
. tempnam
. tmpfile
. touch
. umask
. unlink

6.10.24 fgets() Renvoie la ligne courante sur laquelle se trouve le pointeur du fichier

[ Exemples avec fgets ]   PHP 3, PHP 4, PHP 5

string  fgets ( resource   handle , int   length )

fgets retourne la chaîne lue jusqu'à la longueur length - 1 octet depuis le pointeur de fichier handle , ou bien la fin du fichier, ou une nouvelle ligne (qui inclue la valeur retournée), ou encore un EOF (celui qui arrive en premier). Si aucune longueur n'est fournie, la longueur par défaut est de 1 ko ou 1024 octets.

Si une erreur survient, fgets retourne FALSE .

Erreur courante :

Les programmeurs habitués à la programmation 'C' noteront que fgets ne se comporte pas comme son équivalent C lors de la rencontre de la fin du fichier.

Le pointeur de fichier doit être valide et pointer sur un fichier ouvert avec succès par fopen ou fsockopen (et pas encore fermé par fclose ).

Un exemple simple :
Lecture d'un fichier ligne par ligne

<?php
$handle = @fopen("/tmp/inputfile.txt", "r");
if ($handle) {
   while (!feof($handle)) {
      $buffer = fgets($handle, 4096);
      echo $buffer;
   }
   fclose($handle);
}
?>

Note

Le paramètre length est devenu optionnel depuis PHP 4.2.0. S'il est omis, il prend la valeur par défaut de 1024. Depuis PHP 4.3.0, omettre le paramètre length fait que la fonction va continuer à lire le flux jusqu'à ce que la ligne s'achève. Si la majorité des lignes du fichier dépassent les 8 ko, il est plus efficace pour votre script de spécifier ce paramètre.

Note

fgets est compatible avec les données binaires depuis PHP 4.3. Les versions plus anciennes ne le sont pas.

Note

Si vous avez des problèmes avec PHP qui ne reconnaît pas certaines lignes lors de la lecture de fichier qui ont été créé ou lus sur un MacIntosh, vous pouvez activer l'option de configuration auto_detect_line_endings .

Voir aussi fgetss fread , fgetc , stream_get_line , fopen , popen , fsockopen et stream_set_timeout .

<< fgets >>
fgetcsv Système de fichiers fgetss