Utilisation des gestionnaires d'Apache (handlers)

Qu'est-ce qu'un gestionnaire ?

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.

þ 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.

Note du programmeur

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 :

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.