stream_copy_to_stream

(PHP 5, PHP 7, PHP 8)

stream_copy_to_streamCopies data from one stream to another

说明

stream_copy_to_stream ( resource $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$dest11024) . " bytes copied to first1k.txt\n";
echo 
stream_copy_to_stream($src$dest2) . " bytes copied to remainder.txt\n";

?>

参见

User Contributed Notes

divinity76 at gmail dot com 29-Nov-2018 10:54
note that this function does not actually use sendfile() on linux systems (at least not in PHP 7.2.12)
felix dot nensa at gmail dot com 26-May-2010 04:57
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;
    }

?>
none at noone dot com 15-Jun-2007 04:27
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.
PHP8中文手册 站长在线 整理 版权归PHP文档组所有