stream_get_contents

(PHP 5, PHP 7)

stream_get_contents — Читает оставшуюся часть потока в строку

Описание

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

Похожа на функцию file_get_contents(), за исключением того, что stream_get_contents() работает с уже открытым ресурсом потока и возвращает оставшуюся часть содержимого в строку размером до maxlength байт и начиная с указанного смещения offset.

Список параметров

handle (resource): Ресурс потока (например, полученный при помощи функции fopen())
maxlength (int): Максимальное количество байт для чтения. По умолчанию -1 (прочитать весь оставшийся буфер).
offset (int): Перейти к указанному смещению перед чтением. Если это число отрицательное, то переход не произойдёт и чтение начнётся с текущей позиции.

Возвращаемые значения

Возвращает строку или false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования stream_get_contents()


<?php

if ($stream = fopen('http://www.example.com', 'r')) {
    // вывести всю страницу начиная со смещения 10
    echo stream_get_contents($stream, -1, 10);

    fclose($stream);
}


if ($stream = fopen('http://www.example.net', 'r')) {
    // вывести первые 5 байт
    echo stream_get_contents($stream, 5);

    fclose($stream);
}

?>

Примечания

Замечание: Эта функция безопасна для обработки данных в двоичной форме.

Смотрите также

fgets() - Читает строку из файла
fread() - Бинарно-безопасное чтение файла
fpassthru() - Выводит все оставшиеся данные из файлового указателя