fgets

fgets(resource $stream, [int $length]): string
```php

Recupera la línea actual a partir de la posición del puntero de archivo.

## Parámetros

`stream`  
El puntero de fichero debe ser válido y apuntar a un archivo abierto con éxito por `fopen` o `fsockopen` (y no cerrado aún por `fclose`).

`length`  
Lee hasta la longitud `length` - 1 byte desde el puntero de archivo `stream`, o bien el final del archivo, o una nueva línea (que es incluida en el valor devuelto), o un EOF (el que llegue primero). Si no se proporciona longitud, la función leerá el flujo hasta el final de la línea.

## Valores devueltos

Devuelve un `string` que contiene los `length` primeros caracteres, menos 1 byte desde el puntero de archivo `stream`. `false` es devuelto si no hay más datos para leer.

Si ocurre un error, la función devuelve `false`.

## Ejemplos

Lectura de un archivo línea por línea