stream_copy_to_stream
PHP Manual
PHP Manual»Fonctions sur les flux»stream_copy_to_stream

stream_copy_to_stream

(PHP 5, PHP 7, PHP 8)

stream_copy_to_stream — Copie des données depuis un flux vers un autre

Description

function 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 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é.

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

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.

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";

?>

Notes

Note:

Lorsque from est 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. false peut alors être retourné, alors que les données lues jusque-là ont déjà été écrites dans to. Ce délai d'expiration vaut par défaut default_socket_timeout et peut être modifié avec stream_set_timeout().

Voir aussi

To Top