PHP Velho Oeste 2024

stream_copy_to_stream

(PHP 5, PHP 7, PHP 8)

stream_copy_to_streamCopia dados de um fluxo para outro

Descrição

stream_copy_to_stream(
    resource $from,
    resource $to,
    ?int $length = null,
    int $offset = 0
): int|false

Faz uma cópia dos dados com um comprimento em bytes definido em length, a partir da posição atual (ou a partir da posição offset, se especificada) do fluxo from para o fluxo to. Se length for null, todo o conteúdo remanescente em from será copiado.

Parâmetros

from

O fluxo de origem

to

O fluxo de destino

length

Máximo de bytes a copiar. Por padrão todos os bytes restantes são copiados.

offset

O deslocamento a partir do qual deve-se começar a copiar os dados

Valor Retornado

Retorna a contagem total de bytes copiados, ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.0.0 length agora pode ser nulo.

Exemplos

Exemplo #1 Um exemplo de 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) . " bytes copiados para first1k.txt\n";
echo
stream_copy_to_stream($src, $dest2) . " bytes copiados para remainder.txt\n";

?>

Veja Também

add a note

User Contributed Notes 2 notes

up
1
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)
up
1
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.
To Top