stream_get_contents

    (PHP 5, PHP 7, PHP 8)

    stream_get_contents — Transfiere 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ónDescripció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, -1, 10);

    fclose($stream);
    }


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

    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
    To Top