(PHP 5, PHP 7, PHP 8)
stream_get_contents — Lit tout un flux dans une chaîne
$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.
stream (resource)Une ressource de flux (e.g. retournée par la fonction fopen())
length (entier)
Le nombre maximal d'octets à lire. Par défaut, null
(lit tout le contenu restant du buffer).
offset (entier)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.
Retourne une chaîne de caractères ou false si une erreur survient.
| Version | Description |
|---|---|
| 8.0.0 |
length est désormais nullable.
|
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.exemple.net', 'r')) {
// Affichage des 5 premiers octets
echo stream_get_contents($stream, 5);
fclose($stream);
}
?>
Note: Cette fonction gère les chaînes binaires.
Note:
Lorsque vous spécifiez une valeur de
lengthautre quenull, cette fonction allouera immédiatement un tampon interne de cette taille, même si le contenu réel est significativement plus court.