stream_get_contents

(PHP 5, PHP 7, PHP 8)

stream_get_contentsTransfiere el resto de un flujo a una cadena

Descripción

stream_get_contents(resource $handle, int $maxlength = -1, int $offset = -1): string

Idéntica a file_get_contents(), excepto que stream_get_contents() opera sobre un recurso de flujo ya abierto y devuelve el resto del contenido en una cadena, hasta maxlength bytes y comenzando por el offset especificado.

Parámetros

handle (resource)

Un recurso de flujo (p.ej. devuelto desde fopen())

maxlength (integer)

El máximo de bytes a leer. Por defecto es -1 (lee todo el buffer restante).

offset (integer)

Busca el índice especificado antes de leer. Si este número es negativo, no se hará ninguna búsqueda y la lectura comenzará desde la posición actual.

Valores devueltos

Devuelve una cadena o false en caso de error.

Historial de cambios

Versión Descripción
5.1.0 Se añadió el parámetro offset.

Ejemplos

Ejemplo #1 Ejemplo de stream_get_contents()

<?php

if ($stream fopen('http://www.example.com''r')) {
    
// imprimir toda la página empezando por el índice 10
    
echo stream_get_contents($stream, -110);

    
fclose($stream);
}


if (
$stream fopen('http://www.example.net''r')) {
    
// imprimir los 5 primeros bytes
    
echo stream_get_contents($stream5);

    
fclose($stream);
}

?>

Notas

Nota: Esta función es segura binariamente.

Ver también

  • fgets() - Obtiene una línea desde el puntero a un fichero
  • fread() - Lectura de un fichero en modo binario seguro
  • fpassthru() - Escribe toda la información restante de un puntero a un archivo