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

現在の位置（あるいはもし指定されていれば offset の位置）から最大 length バイトのデータを from から to にコピーします。もし length が null の場合は、from にある残りすべてのデータがコピーされます。

パラメータ

from: コピー元のストリーム。
to: コピー先のストリーム。
length: コピーする最大バイト数。デフォルトでは、残りの全てのデータがコピーされます。
offset: コピーを開始する位置。

戻り値

コピーされたバイト数を返します。失敗した場合に false を返します。

変更履歴

バージョン	説明
8.0.0	`length` は、nullable になりました。

例

例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 3 notes

down

divinity76 at gmail dot com ¶

4 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 ¶

15 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.

down

-2

felix dot nensa at gmail dot com ¶

12 years ago


As stream_copy_to_stream() seems to be quite a memory hog (at least in PHP 5.1.6 64-bit) it may be way more efficient just to copy streams with this simple PHP alternative:

<?php

    function pipe_streams($in, $out)
    {
        $size = 0;
        while (!feof($in)) $size += fwrite($out,fread($in,8192));
        return $size;
    }

?>

＋add a note