PHP | Función fgets()

La función fgets() en PHP es una función incorporada que se usa para devolver una línea desde un archivo abierto.

• Se utiliza para devolver una línea desde un puntero de archivo y deja de devolver en una longitud específica, al final del archivo (EOF) o en una nueva línea, lo que ocurra primero.
• El archivo a leer y el número de bytes a leer se envían como parámetros a la función fgets() y esta devuelve una string de longitud -1 bytes del archivo apuntado por el usuario.
• Devuelve False en caso de falla.

Sintaxis:

fgets(file, length)

Parameters Used:
The fgets() function in PHP accepts two parameters.
file : It specifies the file from which characters have 
to be extracted. 
length : It specifies the number of bytes to be 
read by the fgets() function. The default value 
is 1024 bytes.

Valor devuelto: Devuelve una string de longitud -1 bytes del archivo apuntado por el usuario o Falso en caso de falla.

Errores y excepciones

1. La función no está optimizada para archivos grandes, ya que lee una sola línea a la vez y puede llevar mucho tiempo leer completamente un archivo grande.
2. El búfer debe borrarse si la función fgets() se usa varias veces.
3. La función fgets() devuelve Boolean False pero muchas veces sucede que devuelve un valor no booleano que se evalúa como False.

Supongamos que hay un archivo llamado «gfg.txt» que consta de:

Esta es la primera línea.
Esta es la segunda línea.
Esta es la tercera línea.

Programa 1

<?php
// file is opened using fopen() function
$my_file = fopen("gfg.txt", "rw");
  
// Prints a single line from the opened file pointer
echo fgets($my_file);
  
// file is closed using fclose() function
fclose($my_file);
?>

Producción:

This is the first line.

Programa 2

<?php
//file is opened using fopen() function
$my_file = fopen("gfg.txt", "rw");
  
// prints a single line at a time until end of file is reached
while (! feof ($my_file))
  {
  echo fgets($my_file);
  }
  
// file is closed using fclose() function
fclose($my_file);
?>

Producción:

This is the first line.
This is the second line.
This is the third line.

Referencia:
http://php.net/manual/en/function.fgets.php