Uso de los Handlers en Apache 2i155a

Qu es un Handler? k6p5p

Un "handler" es una representacin interna de Apache de una accin que se va a ejecutar cuando hay una llamada a un fichero. Generalmente, los ficheros tienen handlers implcitos, basados en el tipo de fichero de que se trata. Normalmente, todos los ficheros son simplemente servidos por el servidor, pero algunos tipos de ficheros se tratan de forma diferente.

Handlers pueden ser usados de manera explicita, basndose en la extensin del fichero o en la ubicacin en la que est, se pueden especificar handlers sin tener en cuenta el tipo de fichero que se trate. Esto es una ventaja por dos razones. Primero, es una solucin ms elegante. Segundo, porque a un fichero se le pueden asignar tanto un tipo como un handler. (Consulte tambin la seccin Ficheros y extensiones mltiples.)

Los Handlers pueden tanto ser compilados con el servidor como incluidos en un mdulo, o aadidos con la directiva Action. Los handlers que vienen incluidos en el core con el servidor de la distribucin estndar de Apache son:

• default-handler: Enva el fichero usando el default_handler(), que es el handler usado por defecto para tratar contenido esttico. (core)
• send-as-is: Enva el fichero con cabeceras HTTP tal y como es. (mod_asis)
• cgi-script: Trata el fichero como un sript CGI. (mod_cgi)
• imap-file: Trata el fichero como un mapa de imgenes. (mod_imagemap)
• server-info: Extrae la informacin de configuracin del servidor. (mod_info)
• server-status: Extrae el informe del estado del servidor. (mod_status)
• type-map: Trata el fichero como una correspondencia de tipos para la negociacin de contenidos. (mod_negotiation)

Ejemplos 5p646o

Modificar contenido esttico usando un script CGI 611n3e

Las siguientes directivas hacen que cuando haya una peticin de ficheros con la extensin html se lance el script CGI footer.pl.

En este caso, el script CGI es el responsable de enviar el documento originalmente solicitado (contenido en la variable de entorno PATH_TRANSLATED) y de hacer cualquier modificacin o aadido deseado.

Archivos con cabeceras HTTP i6m59

Las siguientes directivas activan el handler send-as-is, que se usa para ficheros que contienen sus propias cabeceras HTTP. Todos los archivos en el directorio /web/htdocs/asis/ sern procesados por el handler send-as-is, sin tener en cuenta su extension.

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

Nota para programadores 4w631r

Para implementar las funcionalidades de los handlers, se ha hecho un aadido a la API de Apache que puede que quiera usar. Para ser ms especficos, se ha aadido un nuevo registro a la estructura request_rec:

char *handler

Si quiere que su mdulo llame a un handler , solo tiene que aadir r->handler al nombre del handler en cualquier momento antes de la fase invoke_handler de la peticin. Los handlers se implementan siempre como se haca antes, aunque usando el nombre del handler en vez de un tipo de contenido. Aunque no es de obligado cumplimiento, la convencin de nombres para los handlers es que se usen palabras separadas por guiones, sin barras, de manera que no se invada el media type name-space.