Fonction fgets() en PHP
Définition et utilisation
La fonction fgets() lit une ligne à partir du pointeur de fichier.
Syntaxe
fgets(file,length)
| Paramètres | Description |
|---|---|
| file | Obligatoire. Définit le fichier à lire. |
| length | Facultatif. Définit le nombre d'octets à lire. La valeur par défaut est de 1024 octets. |
Description
de file Lit une ligne dans le fichier pointé par et retourne une longueur maximale de length - Une chaîne de caractères de -1 octet. Rencontre la nouvelle ligne (y compris dans la valeur de retour), EOF ou a lu length - S'arrête après -1 octet (selon ce qui se produit en premier). Si aucun n'est spécifié length, il est par défaut de 1K, ou 1024 octets.
Retourne false si l'échec.
Avis et commentaires
Remarque :length Le paramètre est devenu optionnel depuis PHP 4.2.0. Si il est ignoré, la longueur de la ligne est supposée être de 1024 octets. Depuis PHP 4.3, ignorer length Continuera à lire les données du flux jusqu'à la fin de la ligne. Si la plupart des lignes du fichier sont supérieures à 8 KB, il est plus efficace de spécifier la longueur maximale de la ligne dans le script en termes de ressources.
Remarque :Depuis PHP 4.3, cette fonction peut être utilisée en toute sécurité pour les fichiers binaires. Les versions précédentes ne le peuvent pas.
Remarque :Si PHP ne peut pas reconnaître le marqueur de fin de ligne des fichiers Macintosh lors de la lecture de fichiers, vous pouvez activer l'option de configuration runtime auto_detect_line_endings.
Exemple
Exemple 1
<?php
$file = fopen("test.txt","r");
echo fgets($file);
fclose($file);
?>
La sortie est similaire à :
Bonjour, c'est un fichier de test.
Exemple 2
<?php
$file = fopen("test.txt","r");
while(! feof($file))
{
echo fgets($file) . "<br />";
}
fclose($file);
?>
La sortie est similaire à :
Bonjour, c'est un fichier de test. Il y a trois lignes ici. C'est la dernière ligne.
