note that this function does not actually use sendfile() on linux systems (at least not in PHP 7.2.12)
(PHP 5, PHP 7, PHP 8)
stream_copy_to_stream — Copies data from one stream to another
$from
, resource $to
, int|null $length
= null
, int $offset
= 0
) : int|false
Makes a copy of up to length
bytes
of data from the current position (or from the
offset
position, if specified) in
from
to to
. If
length
is null
, all remaining content in
from
will be copied.
from
The source stream
to
The destination stream
length
Maximum bytes to copy. By default all bytes left are copied.
offset
The offset where to start to copy data
Returns the total count of bytes copied, 或者在失败时返回 false
.
版本 | 说明 |
---|---|
8.0.0 |
length is now nullable.
|
Example #1 A stream_copy_to_stream() example
<?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) . " bytes copied to first1k.txt\n";
echo stream_copy_to_stream($src, $dest2) . " bytes copied to remainder.txt\n";
?>
note that this function does not actually use sendfile() on linux systems (at least not in PHP 7.2.12)
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;
}
?>
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.