(PHP 5, PHP 7, PHP 8)
stream_copy_to_stream — Copie des données depuis un flux vers un autre
$from,$to,$length = null,$offset = 0
Fait une copie jusqu'à length octets de
données depuis from vers to,
en partant de la position courante dans from, ou de
offset s'il est supérieur à 0.
Si length vaut null, tout le reste du contenu de
from sera copié.
fromLe flux de source
toLe flux de destination
lengthNombre maximal d'octets à copier. Par défaut, tous les octets restants sont copiés.
offset
Si supérieur à 0, position dans
from, comptée depuis le début du flux,
à partir de laquelle démarrer la copie : from
est d'abord déplacé à cette position, comme avec
fseek() et SEEK_SET.
Si 0 (la valeur par défaut) ou négatif, aucun
déplacement n'est effectué et la copie démarre à la position courante
dans from.
Retourne le nombre total d'octets copiés, ou false si une erreur survient.
| Version | Description |
|---|---|
| 8.0.0 |
length est désormais nullable.
|
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";
?>Note:
Lorsque
fromest un flux de socket en mode bloquant, la copie s'arrête dès qu'aucune donnée n'est reçue dans le délai d'expiration du flux, même si la fin du flux n'a pas été atteinte.falsepeut alors être retourné, alors que les données lues jusque-là ont déjà été écrites dansto. Ce délai d'expiration vaut par défaut default_socket_timeout et peut être modifié avec stream_set_timeout().