Utilisation des gestionnaires d'Apache (handlers)

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

Qu'est-ce qu'un gestionnaire ? mod_actions mod_asis mod_cgi mod_imagemap mod_info mod_mime mod_negotiation mod_status Action AddHandler RemoveHandler SetHandler

Un "gestionnaire" est une représentation interne à Apache de l'action qui doit être entreprise quand un fichier est appelé. En général, les fichiers ont des gestionnaires implicites, basés sur le type du fichier. Normalement, tous les fichiers sont traités simplement par le serveur, mais certains types de fichiers sont "gérés" séparément.

Les gestionnaires peuvent aussi être configurés explicitement, soit en fonction des extensions des noms de fichier, soit en fonction du chemin du fichier, sans faire référence au type de fichier. Ceci a le double avantage d'être une solution plus élégante, et aussi d'autoriser à associer à la fois un type et un gestionnaire avec un fichier. (Voir aussi Fichiers avec extensions multiples.)

Les gestionnaires peuvent être soit partie intégrante du serveur ou inclus dans un module, soit ajoutés à l'aide de la directive Action. Les gestionnaires intégrés dans la distribution standard se présentent comme suit :

default-handler: envoie le fichier en utilisant le default_handler(), qui est le gestionnaire utilisé par défaut pour traiter les contenus statiques. (core)
send-as-is: envoie les fichiers avec 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 de descriptions d'images (imagemap). (mod_imagemap)
server-info: Extrait des informations sur la configuration du serveur. (mod_info)
server-status: Rédige un rapport sur le statut du serveur. (mod_status)
type-map: Traite le fichier comme une description de type pour la négociation du contenu. (mod_negotiation)

Exemples

Modification d'un contenu statique à l'aide d'un script CGI

Les directives suivantes vont faire en sorte que les requêtes pour des fichiers possédant une extension html déclenchent l'exécution du script CGI footer.pl.

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

À ce moment-là, le script CGI se charge d'envoyer le document initialement demandé (référencé par la variable d'environnement PATH_TRANSLATED) et d'effectuer tous ajout ou modification voulus.

Fichiers avec en-têtes HTTP

Les directives suivantes vont activer le gestionnaire send-as-is, qui est utilisé pour les fichiers qui possèdent leurs propres en-têtes HTTP. Tous les fichiers situés dans le répertoire /web/htdocs/asis/ seront traités par le gestionnaire send-as-is, sans tenir compte de l'extension de leur nom de fichier.

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

Note du développeur

Pour implémenter la fonctionnalité des gestionnaires, l' API Apache a fait l'objet d'un ajout que vous pourriez être amené à utiliser. Plus précisément, un nouvel enregistrement a été ajouté à la structure request_rec :

char *handler

Si vous voulez que votre module déclenche l'utilisation d'un gestionnaire, il vous suffit de définir r->handler avec le nom du gestionnaire à n'importe quel moment avant l'étape invoke_handler de la requête. Les gestionnaires sont implémentés comme auparavant, quoique l'on utilise le nom du gestionnaire à la place d'un type de contenu. Bien que ce ne soit pas obligatoire, la convention de nommage des gestionnaires stipule l'utilisation d'un mot composé séparé par des tirets, sans slashes, afin de ne pas interférer avec l'espace de nommage des types de média.