Función fgets() de PHP

Definición y uso

La función fgets() lee una línea desde un puntero de archivo.

Sintaxis

fgets(file,longitud)
Parámetros Descripción
file Obligatorio. Define el archivo que se debe leer.
longitud Opcional. Define el número de bytes que se deben leer. El valor predeterminado es 1024 bytes.

Descripción

desde file Leer una línea del archivo apuntado y devolver la longitud máxima de longitud - Una cadena de 1 byte. Al encontrar un carácter de nueva línea (incluido en el valor de retorno), EOF o haber leído longitud - Detenerse después de 1 byte (dependiendo de lo que se encuentre primero). Si no se especifica longitud, se establece por defecto en 1K, o 1024 bytes.

Si falla, devuelve false.

Sugerencias y notas

Notas:longitud El parámetro se volvió opcional desde PHP 4.2.0. Si se omite, la longitud de la línea se asume como 1024 bytes. Desde PHP 4.3, se omite longitud Continuará leyendo datos del flujo hasta el final de la línea. Si la mayoría de las líneas del archivo son mayores de 8 KB, especificar la longitud máxima de la línea en el script es más efectivo en términos de recursos.

Notas:Desde PHP 4.3, esta función se puede usar de manera segura en archivos binarios. Las versiones anteriores no son compatibles.

Notas:Si PHP no puede identificar el carácter de fin de línea del archivo Macintosh al leer el archivo, puede activar la opción de configuración de tiempo de ejecución auto_detect_line_endings.

Ejemplo

Ejemplo 1

<?php
$file = fopen("test.txt","r");
echo fgets($file);
fclose($file);
?>

La salida es similar a:

Hola, este es un archivo de prueba.

Ejemplo 2

<?php
$file = fopen("test.txt","r");
while(! feof($file))
  {
  echo fgets($file) . "<br />";
  }
fclose($file);
?>

La salida es similar a:

Hola, este es un archivo de prueba. 
Hay tres líneas aquí. 
Esta es la última línea.