(PHP 4, PHP 5, PHP 7)
fgets — Récupère la ligne courante sur laquelle se trouve le pointeur du fichier
$handle
[, int $length
] ) : stringRécupère la ligne courante sur laquelle se trouve le pointeur du fichier.
handleLe 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()).
length
Lit jusqu'à la taille length - 1 octet
depuis le pointeur de fichier handle,
ou bien la fin du fichier, ou une nouvelle ligne (qui est inclue
dans la valeur retournée), ou encore un EOF (celui qui arrive en
premier). Si aucune longueur n'est fournie, la fonction lira
le flux jusqu'à la fin de la ligne.
Retourne une chaîne de caractères contenant les length premiers
caractères, moins 1 octet depuis le pointeur de fichier
handle. FALSE est retourné s'il n'y a plus de
données à lire.
Si une erreur survient, la fonction retourne FALSE.
Exemple #1 Lecture d'un fichier ligne par ligne
<?php
$handle = @fopen("/tmp/inputfile.txt", "r");
if ($handle) {
while (($buffer = fgets($handle, 4096)) !== false) {
echo $buffer;
}
if (!feof($handle)) {
echo "Erreur: fgets() a échoué\n";
}
fclose($handle);
}
?>
Note: Si PHP ne reconnaît pas correctement les fins de lignes lors de la lecture de fichiers qui ont été créés ou lus sur un Macintosh, l'activation de l'option de configuration auto_detect_line_endings peut régler le problème.
Note:
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.