Documentación offline PHP master

stream_get_contents

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

stream_get_contents

Lee todo un flujo en un string

Descripción#

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

`stream_get_contents` es idéntica a `file_get_contents`, salvo que opera sobre un puntero de fichero ya abierto y devuelve el contenido restante, hasta `length` bytes, en un string y comenzando en la posición `offset`.

## Parámetros

`stream` (`resource`)  
Un `resource` de flujo (por ejemplo, devuelto por la función `fopen`)

`length` (`int`)  
El número máximo de bytes a leer. Por omisión, `null` (lee todo el contenido restante del buffer).

`offset` (`int`)  
Se desplaza a la posición especificada antes de la lectura. Si el número pasado es negativo, no se realizará ningún desplazamiento y la lectura comenzará desde la posición actual.

## Valores devueltos

Devuelve un `string` o `false` si ocurre un error.

## Historial de cambios

| Versión | Descripción                 |
|---------|-----------------------------|
| 8.0.0   | `length` ahora es nullable. |

## Ejemplos

Ejemplo con `stream_get_contents`

```php

Notas#

[!NOTE] Esta función es segura para sistemas binarios.

[!NOTE] Cuando se especifica un valor de length distinto de null, esta función asignará inmediatamente un buffer interno de ese tamaño, incluso si el contenido real es significativamente más corto.

Véase también#

fgets, fread, fpassthru