mod_browser.c
, et est compilé par défaut. Il définit des variables d'environnement basées sur les informations sur le navigateur client. Ce module n'apparaît que dans les versions 1.2.* d'Apache. A partir de la version 1.3 d'Apache le module mod_setenvif
intègre les fonctionnalités de ce module.
Ce module vous permet de définir des variables d'environnement basées sur le nom du navigateur qui accède à vos documents, et signalé par le champ d'en-tête http User-Agent:
. Il est particulièrement utile lorsque vous utilisez les mécanismes conditionnels du langage HTML tels qu'inclus dans le module XSSI ou PHP, et permet un paramétrage simple des fonctionnalités HTML selon le type de navigateur.
La directive BrowserMatch definit des variables d'environnement selon la valeur du champ d'en-tête http User-Agent. Le premier argument doit être une expression régulière étendue conforme à POSIX.2 (similaire à une expression régulière pour une fonction egrep()). Les arguments restants permettent de spécifier le nom des variables à définir. Leur forme est soit "nomVariable
", "!nomVariable
" ou
"nomVariable=valeur
". La première forme signifie que la variable est initialisée avec la valeur "1". La seconde supprime la variable si elle existait auparavent, la troisième forme définit la variable et l'initialise à la valeur donnée par valeur
. Si la chaîne User-Agent correspond à plusieurs instances de cette directive, alors les résultats seront combinés. Les entrées sont traitées dans leur ordre d'apparition, des instances postérieures pouvant surcharger des instances antérieures.
Par exemple:
BrowserMatch ^Mozilla forms jpeg=yes browser=netscape BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript BrowserMatch MSIE !javascript
La directive BrowserMatchNoCase
est sémantiquement identique à la directive BrowserMatch
. Elle recherche cependant la correspondance sans tenir compte de la casse. Par exemple :
BrowserMatchNoCase mac platform=macintosh BrowserMatchNoCase win platform=windows
Adaptation française © Valery Fremaux / EISTI 1998