array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.fgets.php', 1 => 'fgets', 2 => 'Récupère la ligne courante à partir de l\'emplacement du pointeur sur fichier', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Fonctions sur les systèmes de fichiers', ), 'prev' => array ( 0 => 'function.fgetcsv.php', 1 => 'fgetcsv', ), 'next' => array ( 0 => 'function.fgetss.php', 1 => 'fgetss', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/filesystem/functions/fgets.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

fgets

(PHP 4, PHP 5, PHP 7, PHP 8)

fgets — Récupère la ligne courante à partir de l'emplacement du pointeur sur fichier

Description

fgets(resource $stream, ?int $length = null): string|false

Récupère la ligne courante à partir de l'emplacement du pointeur sur fichier.

Liste de paramètres

stream

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()).

length

Lit jusqu'à la taille length - 1 octet depuis le pointeur de fichier stream, ou bien la fin du fichier, ou une nouvelle ligne (qui est incluse 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.

Valeurs de retour

Retourne une chaîne de caractères contenant les length premiers caractères, moins 1 octet depuis le pointeur de fichier stream. false est retourné s'il n'y a plus de données à lire.

Si une erreur survient, la fonction retourne false.

Exemples

Exemple #1 Lecture d'un fichier ligne par ligne

<?php

$fp = @fopen("/tmp/inputfile.txt", "r");

if ($fp) {
while (($buffer = fgets($fp, 4096)) !== false) {
echo $buffer, PHP_EOL;
}
if (!feof($fp)) {
echo "Erreur: fgets() a échoué\n";
}

fclose($fp);
}

?>

Notes

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.

Voir aussi