Module Apache mod_deflate

Exemples de configurations

Voici une configuration simple qui comprime les contenus � base de texte courants.

AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript

Activation de la compression

Compression de la sortie

La compression est impl�ment�e par le filtre DEFLATE. La directive suivante active la compression des documents dans le conteneur o� elle est plac�e :

SetOutputFilter DEFLATE
SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip

Si vous voulez limiter la compression � certains types MIME particuliers, vous pouvez utiliser la directive AddOutputFilterByType. Voici un exemple o� la compression n'est activ�e que pour les fichiers html de la documentation d'Apache :

<Directory "/your-server-root/manual">
    AddOutputFilterByType DEFLATE text/html
</Directory>

D�compression de la sortie

Le module mod_deflate fournit aussi un filtre permettant de d�comprimer un corps de r�ponse comprim� par gzip. Pour activer cette fonctionnalit�, vous devez ins�rer le filtre INFLATE dans la cha�ne de filtrage en sortie via la directive SetOutputFilter ou AddOutputFilter, comme dans l'exemple suivant :

<Location /dav-area>
    ProxyPass http://example.com/
    SetOutputFilter INFLATE
</Location>

Dans cet exemple, les sorties comprim�es par gzip en provenance de example.com seront d�comprim�es afin de pouvoir �tre �ventuellement trait�es par d'autres filtres.

D�compression de l'entr�e

Le module mod_deflate fournit �galement un filtre permettant de d�comprimer un corps de requ�te comprim� par gzip. Pour activer cette fonctionnalit�, vous devez ins�rer le filtre DEFLATE dans la cha�ne de filtrage en entr�e via la directive SetInputFilter ou AddInputFilter, comme dans l'exemple suivant :

<Location /dav-area>
    SetInputFilter DEFLATE
</Location>

D�sormais, si une requ�te contient un en-t�te Content-Encoding: gzip, son corps sera automatiquement d�comprim�. Peu de navigateurs sont actuellement en mesure de comprimer les corps de requ�tes. Cependant, certaines applications sp�cialis�es supportent les requ�tes comprim�es, comme par exemple certains clients WebDAV.

Prise en compte des serveurs mandataires

Le module mod_deflate envoie un en-t�te de r�ponse HTTP Vary: Accept-Encoding pour avertir les mandataires qu'une r�ponse enregistr�e dans le cache ne doit �tre envoy�e qu'aux clients qui ont envoy� l'en-t�te de requ�te Accept-Encoding appropri�. Ceci permet d'�viter l'envoi d'un contenu comprim� � un client qui ne sera pas en mesure de l'interpr�ter.

Si vous avez d�fini des exclusions sp�cifiques d�pendant, par exemple, de l'en-t�te User-Agent, vous devez ajouter manuellement des donn�es � l'en-t�te Vary afin d'informer les mandataires des restrictions suppl�mentaires. Par exemple, dans la configuration classique o� l'addition du filtre DEFLATE d�pend du contenu de l'en-t�te User-Agent, vous devez sp�cifier :

Header append Vary User-Agent

Si votre d�cision de comprimer le contenu d�pend d'autres informations que celles contenues dans les en-t�tes de la requ�te (par exemple la version HTTP), vous devez attribuer � l'en-t�te Vary la valeur *, ce qui permet d'emp�cher les mandataires compatibles de tout mettre en cache.

Header set Vary *