gzread

(PHP 4, PHP 5, PHP 7, PHP 8)

gzreadLecture de fichier compressé binaire

Description

function gzread(resource $stream, int $length): string|false

gzread() lit jusqu'à length octets dans le fichier compressé gzip, représenté par stream. La lecture s'arrête lorsque length octets (décompressés) ont été lus, ou que la fin du fichier a été atteinte (position EOF).

Liste de paramètres

stream

Le pointeur de fichier gz. Il doit être valide et doit pointer vers un fichier ouvert avec succès grâce à la fonction gzopen().

length

Le nombre d'octets à lire.

Valeurs de retour

Les données qui ont été lues, ou false si une erreur survient.

Historique

Version Description
7.4.0 Cette fonction retourne désormais false en cas d'échec ; auparavant 0 était retourné.

Exemples

Exemple #1 Exemple avec gzread()

<?php
// récupère le contenu d'un fichier gz dans une chaîne
$filename = "/usr/local/something.txt.gz";
$zd = gzopen($filename, "r");
$contents = gzread($zd, 10000);
gzclose($zd);
?>

Voir aussi

  • gzwrite() - Écrit dans un fichier compressé gzip
  • gzopen() - Ouvre un fichier compressé avec gzip
  • gzgets() - Lit une ligne dans un fichier compressé
  • gzgetss() - Lit une ligne dans un fichier compressé, et supprime les balises HTML
  • gzfile() - Lit la totalité d'un fichier compressé
  • gzpassthru() - Affiche toutes les données qui restent dans un pointeur gz