[APACHE DOCUMENTATION]

Apache HTTP Server Version 1.3

Module mod_browser

Ce module est implémenté par le fichier 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.

Résumé

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.

Directives


BrowserMatch

Syntaxe : BrowserMatch regex attr1 attr2...
Contexte : configuration serveur
Statut : base
Module : mod_browser
Compatibilité : à partir de la version 1.2 d'Apache

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

BrowserMatchNoCase

Syntaxe : BrowserMatchNoCase regex attr1 attr2...
Contexte : configuration serveur
Statut : base
Module : mod_browser
Compatibilité : A partir de la version 1.2 d'Apache

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


Apache HTTP Server Version 1.3

Index Home

Adaptation française © Valery Fremaux / EISTI 1998