Module Apache mod_deflate

Codages support�s

Le seul codage support� est gzip afin d'assurer une compl�te compatibilit� avec les anciens navigateurs. Le codage deflate n'est donc pas support� ; voir � ce sujet la documentation de zlib pour une explication d�taill�e.

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 *

Servir du contenu pr�compress�

Comme mod_deflate recompresse le contenu demand� � chaque requ�te, il est possible de gagner en performances en pr�compressant ce contenu, et en for�ant mod_deflate � servir ce contenu pr�compress� sans avoir � le recompresser � chaque requ�te. Pour ce faire, utilisez une configuration du style :

<IfModule mod_headers.c>
    # Servir des fichiers CSS compress�s avec gzip, s'ils existent, et
    # si le client accepte gzip.
    RewriteCond "%{HTTP:Accept-encoding}" "gzip"
    RewriteCond "%{REQUEST_FILENAME}\.gz" "-s"
    RewriteRule "^(.*)\.css"              "$1\.css\.gz" [QSA]
    # Servir des fichiers JS compress�s avec gzip, s'ils existent, et
    # si le client accepte gzip.
    RewriteCond "%{HTTP:Accept-encoding}" "gzip"
    RewriteCond "%{REQUEST_FILENAME}\.gz" "-s"
    RewriteRule "^(.*)\.js"               "$1\.js\.gz" [QSA]
    # Servir des types de contenus corrects, et emp�cher mod_deflate
    # d'effectuer un double gzip.
    RewriteRule "\.css\.gz$" "-" [T=text/css,E=no-gzip:1]
    RewriteRule "\.js\.gz$"  "-" [T=text/javascript,E=no-gzip:1]
    <FilesMatch "(\.js\.gz|\.css\.gz)$">
      # Servir le type de codage correct.
      Header append Content-Encoding gzip
      # Force les mandataires � mettre en cache s�par�ment les fichiers
      # css/js gzipp�s & non gzipp�s.
      Header append Vary Accept-Encoding
    </FilesMatch>
</IfModule>