gzencode

(PHP 4 >= 4.0.4)

gzencode -- Crée une chaîne compressée

Description

string gzencode ( string data [, int level [, int encoding_mode]])

gzencode() retourne la version compressée de la chaîne data, compatible avec le résultat de la commande gzip. Cette fonction retourne FALSE si une erreur survient. Le paramètre optionnel level peut prendre des valeurs comprises entre 0 (pas de compression) et 9 (compression maximale). Par défaut, le niveau de compression est le niveau de la librairie Zlib.

Vous pouvez aussi utiliser les constantes FORCE_GZIP (la valeur par défaut) ou FORCE_DEFLATE comme troisième paramètre optionnel encoding_mode. Si vous utilisez FORCE_DEFLATE, vous obtiendrez une chaîne réduite (deflated) avec les en-têtes Zlib ad hoc, mais sans la somme de contrôle finale CRC32.

Note : level a été ajouté en PHP 4.2. Avant cette version gzencode() n'utilisait que le paramètre data et optionnellement encoding_mode.

La chaîne résultante contient les en-têtes et la structure de données appropriée pour en faire un fichier .gz standard, c'est à dire :

Exemple 1. Créer un fichier gzip

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

Pour plus de détails sur le format de fichier GZIP, reportez-vous à la RFC GZIP file format specification version 4.3 (RFC 1952).

Voir aussi gzcompress() gzuncompress() gzdeflate() et gzinflate().