Ce module donne accès aux fichiers compressés avec l'utilitaire gzip, grâce à des fonctions semblables aux fonctions d'accès aux fichiers, qui fonctionnent avec les fichiers compressés ou non (mais pas avec les sockets).
Note : La version 4.0.4 a introduit la version étendue de fopen() pour les fichiesr 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.
En version 4.3.0, ce préfixe spécial est remplacé par zlib:// pour éviter les ambiguités avec les fichiers contenant des deux points :.
Cette fonctionnalité requiert une librarie C qui fournisse la fonction fopencookie(). A ma connaissance, la librairie GNU libc est la seule à fournir cette fonctionnalité.
Ce module utilise les fonctions de la librairie zlib de Jean-loup Gailly et Mark Adler. Vous devez utiliser zlib version >= 1.0.9 avec ce module.
L'extension zlib offre l'option de compresser à la volée les pages web, si le navigateur client le supporte. Il existe donc deux options dans le fichier de configuration php.ini.
Tableau 1. Options de configuration Zlib
Nom | Défaut | Changeable |
---|---|---|
zlib.output_compression | "0" | PHP_INI_ALL |
zlib.output_compression_level | "-1" | PHP_INI_ALL |
Voici une explication rapide des directives de configuration.
Compression à la volée des pages. Si cette option est mise à "On" dans php.ini ou dans la configuration d'Apache, les page sont compressées si le navigateur envoie un entête HTTP "Accept-Encoding: gzip" ou "deflate". "Content-Encoding: gzip" (respectivement "deflate") et "Vary: Accept-Encoding" sont alors ajoutés au résultat.
Vous pouvez utiliser la fonction ini_set() pour désactiver cette configuration durant un script, si les entêtes HTTP n'ont pas été envoyé. Si vous envoyez un entête "Content-Type: image/", alors la compression sera désactivée (afin d'éviter un bug de Netscape). Vous pouvez réactiver cette compression en utilisant la ligne ini_set('zlib.output_compression', 'On') après avoir appelé la fonction header qui fixe le type.
Cette option accepte aussi des valeurs entières au lieu d'un booléen "On"/"Off". Cela vous permet de modifier la taille du buffer de sortie.
Niveau de compression utilisé pour la compression de sortie.
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.
Précédent | Sommaire | Suivant |
zip_read | Niveau supérieur | gzclose |