(PHP 5, PHP 7, PHP 8)
stream_get_contents — Lee todo un flujo en un string
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
.
stream
(resource)Un recurso de flujo (por ejemplo, devuelto por la función fopen())
length
(entier)
El número máximo de bytes a leer. Por omisión, null
(lee todo el contenido restante del buffer).
offset
(entier)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.
Devuelve un chaîne de caractères o false
en caso de error.
Versión | Descripción |
---|---|
8.0.0 |
length ahora es nullable.
|
Ejemplo #1 Ejemplo con stream_get_contents()
<?php
if ($stream = fopen('http://www.example.com', 'r')) {
// muestra toda la página, comenzando en la posición 10
echo stream_get_contents($stream, -1, 10);
fclose($stream);
}
if ($stream = fopen('http://www.exemple.net', 'r')) {
// Muestra los 5 primeros bytes
echo stream_get_contents($stream, 5);
fclose($stream);
}
?>
Nota: Esta función es segura binariamente.
Nota:
Cuando se especifica un valor de
length
distinto denull
, esta función asignará inmediatamente un buffer interno de ese tamaño, incluso si el contenido real es significativamente más corto.