Ce module vous permet de lire et écrire de manière transparente des fichiers compressés gzip (.gz), avec la plupart des fonctions fichier qui fonctionnent avec les fichiers compressés en gzip (et les fichiers décompressés aussi, mais pas avec les sockets).
Note: La version 4.0.4 a introduit la version étendue de fopen() pour les fichiers compressés avec GZ. Vous pouvez utiliser le préfixe spécial zlib: dans les URL pour accéder directement et de manière transparente aux fichiers compressés par GZ, avec toutes les fonctions f*() habituelles. Cette fonctionnalité requiert une bibliothèque C qui fournit la fonction fopencookie() . A ma connaissance, la bibliothèque GNU libc est la seule à fournir cette fonctionnalité.
En version 4.3.0, zlib: a été changé pour compress.zlib:// pour éviter les ambiguités avec les fichiers contenant les caractères ':'. La fonction fopencookie() n'est plus nécessaire. Plus d'informations sont disponibles dans la section à propos des la section intitulée « Flux compressés » .
Ce module utilise les fonctions de la bibliothèque » zlib de Jean-loup Gailly et Mark Adler. Vous devez utiliser zlib version >= 1.0.9 avec ce module.
Le support de Zlib dans PHP n'est pas activé par défaut. Vous devez compiler PHP avec l'option --with-zlib[=DIR] .
La version Windows de PHP dispose du support automatique de cette extension. Vous n'avez pas à ajouter de bibliothèque supplémentaire pour disposer de ces fonctions.
Note: Le support intégré de zlib pour Windows est disponible depuis PHP 4.3.0.
Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini .
L'extension zlib offre l'option de compresser de manière transparente les pages PHP à la volée, si le navigateur du visiteur le supporte. Voici donc les trois options à utiliser dans le php.ini .
Tableau 347. Options de configuration
| Nom | Par défaut | Modifiable | Historique |
|---|---|---|---|
| zlib.output_compression | "0" | PHP_INI_ALL | Disponible depuis PHP 4.0.5. |
| zlib.output_compression_level | "-1" | PHP_INI_ALL | Disponible depuis PHP 4.3.0. |
| zlib.output_handler | "" | PHP_INI_ALL | Disponible depuis PHP 4.3.0. |
Voici un éclaircissement sur l'utilisation des directives de configuration.
Active ou pas la compression transparente des pages. Si cette option est mise à "On" dans php.ini ou dans la configuration Apache, les pages sont compressées si le navigateur envoie un en-tête "Accept-Encoding: gzip" ou "deflate". Les en-têtes "Content-Encoding: gzip" (respectivement "deflate") et "Vary: Accept-Encoding" sont ajoutés dans la page envoyée au navigateur. En fonctionnement, il peut être défini uniquement avant tout affichage.
Cette option accepte aussi des valeurs entières au lieu des booléens, "On"/"Off", ce qui vous permet de configurer la taille du tampon de sortie (par défaut, il vaut 4ko).
Note: output_handler doit être laissée à vide si cette option est activée. Sinon, vous devez utiliser zlib.output_handler.
Niveau de compression utilisé pour la compression de sortie.
Vous ne pouvez pas spécifier de gestionnaire de sortie supplémentaire si zlib.output_compression est activée. Cette configuration est la même que output_handler mais dans un ordre différent.
Cette extension définit une ressource de pointeur de fichier, retourné par la fonction gzopen() .
Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.
Cet exemple ouvre un fichier temporaire, écrit une page de test dedans, puis affiche le contenu du fichier deux fois.
Exemple 2900. Exemple de l'extension Zlib
<?php
$filename
=
tempnam
(
'/tmp'
,
'zlibtest'
) .
'.gz'
;
echo
"<html>\n<head></head>\n<body>\n<pre>\n"
;
$s
=
"C'est juste un test, test, test, test, test, test, test, test!\n"
;
// ouvre le fichier en écriture avec la compression maximale
$zp
=
gzopen
(
$filename
,
"w9"
);
// écrit une chaîne dans le fichier
gzwrite
(
$zp
,
$s
);
// ferme le fichier
gzclose
(
$zp
);
// ouvre le fichier en lecture
$zp
=
gzopen
(
$filename
,
"r"
);
// lit 3 caractères
echo
gzread
(
$zp
,
3
);
// affiche le reste du fichier, puis le ferme
gzpassthru
(
$zp
);
gzclose
(
$zp
);
echo
"\n"
;
// ouvre le fichier et affiche le fichier une seconde fois
if (
readgzfile
(
$filename
) !=
strlen
(
$s
)) {
echo
"Erreur avec les fonctions zlib!"
;
}
unlink
(
$filename
);
echo
"</pre>\n</body>\n</html>\n"
;
?>