stream_copy_to_stream

(PHP 5, PHP 7, PHP 8)

stream_copy_to_stream — Копирует данные из одного потока в другой

Описание

stream_copy_to_stream(
    resource $from,
    resource $to,
    ?int $length = null,
    int $offset = 0
): int|false

Делает копию до length байт данных от текущей позиции (или от позиции offset, если указана) потока from в поток to. Если length равен null, будет скопировано всё оставшееся содержимое из from.

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

from: Исходный поток.
to: Поток назначения.
length: Максимальное количество байт для копирования. По умолчанию копируются все оставшиеся байты.
offset: Смещение, с которого будут копироваться данные.

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

Возвращает общее количество скопированных байт или false, если возникла ошибка.

Список изменений

Версия	Описание
8.0.0	Параметр `length` теперь допускает значение null.

Примеры

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

<?php
$src = fopen('http://www.example.com', 'r');
$dest1 = fopen('first1k.txt', 'w');
$dest2 = fopen('remainder.txt', 'w');

echo stream_copy_to_stream($src, $dest1, 1024) . " байт скопировано в first1k.txt\n";
echo stream_copy_to_stream($src, $dest2) . " байт скопировано в remainder.txt\n";

?>

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

copy() - Копирует файл

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 2 notes

down

divinity76 at gmail dot com ¶

6 years ago

note that this function does not actually use sendfile() on linux systems (at least not in PHP 7.2.12)

down

none at noone dot com ¶

17 years ago

stream_copy_to_stream almost copies a stream...

$objInputStream = fopen("php://input", "rb");
$objTempStream = fopen("php://temp", "w+b");
stream_copy_to_stream($objInputStream, $objTempStream);

That code will copy a stream but it will also move the stream pointers to EOF.  This is fine if you plan on rewinding the temp stream but good luck rewinding the input stream.

rewind($objTempStream);
rewind($objInputStream);

So as you can see this is stream copy or stream move depending on what kind of stream you are working with, and because there are no peaking functions your effed if you need to read from an input stream in multiple classes that are unrelated.

＋Добавить