PHP Manual»Fonctions sur les flux»stream_get_contents

stream_get_contents

(PHP 5, PHP 7, PHP 8)

stream_get_contents — Lit tout un flux dans une chaîne

Description

function stream_get_contents(resource $stream, ?int $length = null, int $offset = -1): string|false

stream_get_contents() est identique à file_get_contents(), sauf qu'elle opère sur un pointeur de fichier déjà ouvert et retourne le contenu restant, allant jusqu'à length octets, dans une chaîne et commençant à la position offset.

Liste de paramètres

stream (resource): Une resource de flux (e.g. retournée par la fonction fopen())
length (int): Le nombre maximal d'octets à lire. Par défaut, null (lit tout le contenu restant du buffer).
offset (int): Se déplace à la position spécifiée avant la lecture. Si le nombre passé est négatif, aucun déplacement ne sera effectué et la lecture commencera de la position courante.

Valeurs de retour

Retourne une string ou false si une erreur survient.

Historique

Version	Description
8.0.0	`length` est désormais nullable.

Exemples

Exemple #1 Exemple avec stream_get_contents()

<?php

if ($stream = fopen('http://www.example.com', 'r')) {
    // affiche toute la page, en commençant à la position 10
    echo stream_get_contents($stream, -1, 10);

    fclose($stream);
}


if ($stream = fopen('http://www.example.net', 'r')) {
    // Affichage des 5 premiers octets
    echo stream_get_contents($stream, 5);

    fclose($stream);
}

?>

Notes

Note: Cette fonction gère les chaînes binaires.

Note:
Lorsque l'on spécifie une valeur de length autre que null, cette fonction allouera immédiatement un tampon interne de cette taille, même si le contenu réel est significativement plus court.

Voir aussi

fgets() - Récupère la ligne courante à partir de l'emplacement du pointeur sur fichier
fread() - Lecture du fichier en mode binaire
fpassthru() - Affiche le reste du fichier