Manuel PHP - gzencode - Crée une chaîne compressée gzip

Description

string gzencode ( string $data [, int $level = -1 [, int $encoding_mode = FORCE_GZIP ]] )

gzencode() retourne la version compressée de la chaîne data compatible avec la sortie du programme gzip.

Pour plus de détails sur l'algorithme, lisez le document » "ZLIB Compressed Data Format Specification version 4.3" (RFC 1952).

Liste de paramètres

data

Les données à encoder.

level

Le degré de compression. 0 signifie aucune compression, jusqu'à 9 pour une compression maximale. Si omis, le degré de compression par défaut sera celui de la bibliothèque zlib.

encoding_mode

Le mode d'encodage. Peut être FORCE_GZIP (par défaut) ou FORCE_DEFLATE.

Avant PHP 5.4.0, l'utilisation de FORCE_DEFLATE conduit en une chaîne standard zlib (incluant les en-têtes zlib) après l'en-tête de fichier gzip mais sans la somme de vérification (checksum) crc32 finale.

En PHP 5.4.0 et suivant, FORCE_DEFLATE génère un affichage conforme à la RFC 1950, contenant un en-tête zlib, les données standard, et une somme de vérification Adler.

Valeurs de retour

La chaîne encodée ou FALSE si une erreur survient.

Historique

Version	Description
5.4.0	`FORCE_DEFLATE` génère maintenant un affichage conforme à la RFC 1950.
4.2	`level` a été ajouté. gzencode() n'avait que les paramètres `data` et `encoding_mode` (optionnel) avant.

Exemples

Les données résultantes contiennent les en-têtes appropriés ainsi que la structure de données pour faire un fichier .gz standard, e.g. :

Exemple #1 Création d'un fichier gzip

<?php
$data = implode("", file("bigfile.txt"));
$gzdata = gzencode($data, 9);
$fp = fopen("bigfile.txt.gz", "w");
fwrite($fp, $gzdata);
fclose($fp);
?>

Voir aussi

gzdecode() - Décode une chaîne de caractères compressée gzip
gzdeflate() - Compresse une chaîne
gzinflate() - Décompresse une chaîne
gzuncompress() - Décompresse une chaîne compressée
gzcompress() - Compresse une chaîne
» Spécification du format de données compressées ZLIB (RFC 1950)