PHPCon Poland 2024

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() - Копирует файл

add a note

User Contributed Notes 2 notes

up
1
divinity76 at gmail dot com
5 years ago
note that this function does not actually use sendfile() on linux systems (at least not in PHP 7.2.12)
up
1
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.
To Top