PHP Conference Nagoya 2025

stream_copy_to_stream

(PHP 5, PHP 7, PHP 8)

stream_copy_to_streamCopie des données depuis un flux vers un autre

Description

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

Fait une copie jusqu'à length octets de données depuis la position courante du pointeur (ou depuis la position offset, si spécifié) dans le flux from vers le paramètre to. Si length n'est pas spécifié, tout le reste du flux from sera copié.

Liste de paramètres

from

Le flux de source

to

Le flux de destination

length

Nombre maximal d'octets à copier. Par défaut, tous les octets restants sont copiés.

offset

L'offset où démarrer la copie de données

Valeurs de retour

Retourne le nombre total d'octets copiés, ou false si une erreur survient.

Historique

Version Description
8.0.0 length est désormais nullable.

Exemples

Exemple #1 Exemple avec 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) . " octets copiés vers first1k.txt\n";
echo
stream_copy_to_stream($src, $dest2) . " octets copiés vers remainder.txt\n";

?>

Voir aussi

add a note

User Contributed Notes 2 notes

up
1
divinity76 at gmail dot com
6 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
17 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