Utilisation des gestionnaires apache

Langues Disponibles: en | + es | + fr | + ja | + ko | + ru | + tr

+ +

Ce document décrit l'utilisation des gestionnaires (Handlers) Apache.

Qu'est ce qu'un Gestionnaire ?
Exemples
Note aux programmeurs

Qu'est ce qu'un Gestionnaire ?

Modules Apparentés	Directives Apparentées
`mod_actions` `mod_asis` `mod_cgi` `mod_imap` `mod_info` `mod_mime` `mod_negotiation` `mod_status`	`Action` `AddHandler` `RemoveHandler` `SetHandler`

+ + + + +

Un Gestionnaire "handler" est une représentation interne à + Apache, qui décrit quoi faire quand un fichier est appelé. De + manière générale, les fichiers disposent d'un gestionnaire + implicite en fonction de leurs types. Le fonctionnement standard + est de simplement servir le fichier tel qu'il est demandé, mais + certains types de fichiers peuvent être gérés différemment.

+ +

Depuis Apache 1.1, il est possible de forcer l'utilisation + des gestionnaires. Ils peuvent être spécifiés pour des fichiers + présentant une certaine extension ou présents dans un certain + répertoire, et peuvent être utilisés indépendamment des types + des fichiers. Cette technique est avantageuse, d'abord parce + que plus élégante, mais aussi parce qu'on peut ainsi associer + un type de fichier et un gestionnaire à un + fichier. (Voir aussi : Fichiers à Extensions Multiples.)

+ +

Les gestionnaires peuvent être intégrés au serveur, ou inclus + dans un module, ou encore être configurés au moyen de la directive + Action. Les + gestionnaires fournis par défaut dans la distribution d'Apache + se présentent comme suit :

+ +

default-handler : Envoie le fichier en + utilisant default_handler() qui est le + gestionnaire utilisé par défaut pour gérer les contenus + statiques. (noyau d'Apache)
send-as-is : Envoie le fichier avec les + en-têtes HTTP tels quels. (mod_asis)
cgi-script : Traite le fichier comme un + script CGI. (mod_cgi)
imap-file : Traite le fichier comme un + ensemble de règles imagemap. NdT : ces fonctionnalités sont + désuètes, et sont réalisées à présent coté client. + (mod_imap)
server-info : Envoie les informations + de configuration du serveur. (mod_info)
server-status : Envoie les informations sur + le fonctionnement et la charge du serveur. + (mod_status)
type-map : Traite le fichier comme un + fichier de types pour la négociation de contenu. + (mod_negotiation)

Exemples

+ + +

Modifier un contenu statique au moyen d'un script CGI

+ + +

Les directives ci-après provoquent l'exécution du script + CGI footer.pl à chaque requête de fichier + présentant l'extension html.

+ +

+ Action add-footer /cgi-bin/footer.pl + AddHandler add-footer .html +

+ +

Le travail du script CGI est alors d'envoyer le document + demandé (désigné au moyen de la variable d'environnement + PATH_TRANSLATED) en lui faisant subir au préalable + les transformations désirées.

+ + +

Fichiers contenant des en-têtes HTTP

+ + +

Les directives ci-après activent le gestionnaire + send-as-is, utilisé pour gérer les fichiers + qui contiennent leurs propres en-têtes HTTP. Tous les fichiers + contenus dans le répertoire /web/htdocs/asis/ + seront traités par le gestionnaire send-as-is, + sans tenir compte de leurs extensions.

+ +

+ <Directory /web/htdocs/asis> + SetHandler send-as-is + </Directory> +

+ + +

Note aux programmeurs

+ + +

L'API d'Apache a été modifiée + lors de l'implémentation des gestionnaires ; cette modification + peut se révéler intéressante. Un nouvel enregistrement a été ajouté + à la structure request_rec :

+ +

+ char *handler +

+ +

Pour qu'un module utilise un gestionnaire, il suffit d'affecter + r->handler avec le nom du gestionnaire avant + l'étape invoke_handler de la requête. Les + gestionnaires fonctionnent comme auparavant, bien que leurs noms + soient nécessaires au lieu d'un type de contenu. Bien qu'elle ne + soit pas nécessaire, la convention de nommage des gestionnaires + demande l'utilisation de mots séparés par des tirets, ne contenant + aucun slash, afin de ne pas interférer avec l'espace de nommage + des types de médias.