(PHP 4 >= 4.0.4, PHP 5)
gzencode — Crée une chaîne compressée gzip
$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).
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.
La chaîne encodée ou FALSE si une erreur survient.
| 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.
|
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);
?>