stream_copy_to_stream

(PHP 5, PHP 7, PHP 8)

stream_copy_to_stream — データをあるストリームから別のストリームにコピーする

説明

stream_copy_to_stream(
    resource $source,
    resource $dest,
    int $maxlength = -1,
    int $offset = 0
): int|false

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

パラメータ

source: コピー元のストリーム。
dest: コピー先のストリーム。
maxlength: コピーする最大バイト数。
offset: コピーを開始する位置。

返り値

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

例

例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

none at noone dot com ¶

16 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

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)

down

-3

felix dot nensa at gmail dot com ¶

13 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