Utilisation des gestionnaires apache

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.