note that this function does not actually use sendfile() on linux systems (at least not in PHP 7.2.12)
stream_copy_to_stream
(PHP 5, PHP 7, PHP 8)
stream_copy_to_stream — Копирует данные из одного потока в другой
Описание
stream_copy_to_stream(
resource
resource
?int
int
): int|false
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";
?>
add a note
User Contributed Notes 2 notes
divinity76 at gmail dot com ¶
5 years ago
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.
