41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd<?xml version="1.0" encoding="UTF-8" ?>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd<?xml-stylesheet type="text/xsl" href="/style/manual.es.xsl"?>
a99c5d4cc3cab6a62b04d52000dbc22ce1fa2d94coar<!-- English Revision: 151408:1673945 (outdated) -->
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd<!--
031b91a62d25106ae69d4693475c79618dd5e884fielding Licensed to the Apache Software Foundation (ASF) under one or more
031b91a62d25106ae69d4693475c79618dd5e884fielding contributor license agreements. See the NOTICE file distributed with
031b91a62d25106ae69d4693475c79618dd5e884fielding this work for additional information regarding copyright ownership.
031b91a62d25106ae69d4693475c79618dd5e884fielding The ASF licenses this file to You under the Apache License, Version 2.0
031b91a62d25106ae69d4693475c79618dd5e884fielding (the "License"); you may not use this file except in compliance with
031b91a62d25106ae69d4693475c79618dd5e884fielding the License. You may obtain a copy of the License at
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd http://www.apache.org/licenses/LICENSE-2.0
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd Unless required by applicable law or agreed to in writing, software
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd distributed under the License is distributed on an "AS IS" BASIS,
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd See the License for the specific language governing permissions and
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd limitations under the License.
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd-->
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd<manualpage metafile="handler.xml.meta">
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <title>Uso de los Handlers en Apache</title>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <summary>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <p>Este documento describe el uso de los Handlers en Apache.</p>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd </summary>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <section id="definition">
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <title>¿Qu&#233; es un Handler?</title>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <related>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <modulelist>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <module>mod_actions</module>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <module>mod_asis</module>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <module>mod_cgi</module>
7eaa41bc322620d14365712c9fc8438f7a330d8dnd <module>mod_imagemap</module>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <module>mod_info</module>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <module>mod_mime</module>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <module>mod_negotiation</module>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <module>mod_status</module>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd </modulelist>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <directivelist>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <directive module="mod_actions">Action</directive>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <directive module="mod_mime">AddHandler</directive>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <directive module="mod_mime">RemoveHandler</directive>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <directive module="core">SetHandler</directive>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd </directivelist>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd </related>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <p>Un "handler" es una representaci&#243;n interna de Apache de
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd una acci&#243;n que se va a ejecutar cuando hay una llamada a un
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd fichero. Generalmente, los ficheros tienen handlers
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd impl&#237;citos, basados en el tipo de fichero de que se
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd trata. Normalmente, todos los ficheros son simplemente servidos
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd por el servidor, pero algunos tipos de ficheros se tratan de forma
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd diferente.</p>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <p>Apache 1.1 a&#241;ade la posibilidad de usar handlers
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd explicitamente. Bas&#225;ndose en la extension del fichero o en
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd la ubicaci&#243;n en la que este, se pueden especificar handlers
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd sin tener en cuenta el tipo de fichero de que se trate. Esto es
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd una ventaja por dos razones. Primero, es una soluci&#243;n
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd m&#225;s elegante. Segundo, porque a un fichero se le pueden
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd asignar tanto un tipo <strong>como</strong> un handler. (Consulte
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd tambi&#233;n la secci&#243;n <a
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd href="mod/mod_mime.html#multipleext">Ficheros y extensiones
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd m&#250;ltiples</a>.)</p>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <p>Los Handlers pueden ser tanto ser compilados con el servidor
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd como incluidos en un m&#243;dulo, como a&#241;adidos con la
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd directiva <directive module="mod_actions">Action</directive>. Los
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd handlers compilados con el servidor de la distribuci&#243;n
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd est&#225;ndar de Apache son:</p>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <ul>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <li><strong>default-handler</strong>: Env&#237;a el fichero
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd usando el <code>default_handler()</code>, que es el handler
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd usado por defecto para tratar contenido
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd est&#225;tico. (core)</li>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <li><strong>send-as-is</strong>: Env&#237;a el fichero con
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd cabeceras HTTP tal y como es. (<module>mod_asis</module>)</li>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <li><strong>cgi-script</strong>: Trata el fichero como un sript
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd CGI. (<module>mod_cgi</module>)</li>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <li><strong>imap-file</strong>: Trata el fichero como un mapa de
7eaa41bc322620d14365712c9fc8438f7a330d8dnd im&#225;genes. (<module>mod_imagemap</module>)</li>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <li><strong>server-info</strong>: Extrae la informaci&#243;n de
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd configuraci&#243;n del
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd servidor. (<module>mod_info</module>)</li>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <li><strong>server-status</strong>: Extrae el informe de estado
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd del servidor. (<module>mod_status</module>)</li>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <li><strong>type-map</strong>: Trata el fichero como una
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd correspondencia de tipos para la negociaci&#243;n de contenidos.
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd (<module>mod_negotiation</module>)</li> </ul> </section>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <section id="examples"> <title>Ejemplos</title>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <section id="example1">
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <title>Modificar contenido est&#225;tico usando un script
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd CGI</title>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <p>Las siguientes directivas hacen que cuando haya una
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd petici&#243;n de ficheros con la extensi&#243;n
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <code>html</code> se lance el script CGI
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <code>footer.pl</code>.</p>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <example>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd Action add-footer /cgi-bin/footer.pl<br/>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd AddHandler add-footer .html
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd </example>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <p>En este caso, el script CGI es el responsable de enviar el
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd documento originalmente solicitado (contenido en la variable de
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd entorno <code>PATH_TRANSLATED</code>) y de hacer cualquier
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd modificaci&#243;n o a&#241;adido deseado.</p>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd </section>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <section id="example2">
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <title>Archivos con cabaceras HTTP</title>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <p>Las siguientes directivas activan el handler
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <code>send-as-is</code>, que se usa para ficheros que contienen
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd sus propias cabeceras HTTP. Todos los archivos en el directorio
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <code>/web/htdocs/asis/</code> ser&#225;n procesados por el
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd handler <code>send-as-is</code>, sin tener en cuenta su
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd extension.</p>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <example>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd &lt;Directory /web/htdocs/asis&gt;<br/>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd SetHandler send-as-is<br/>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd &lt;/Directory&gt;
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd </example>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd </section>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd </section>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <section id="programmer">
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <title>Nota para programadores</title>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <p>Para implementar las funcionalidades de los handlers, se ha
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd hecho un a&#241;adido a la <a href="developer/API.html">API de
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd Apache</a> que puede que quiera usar. Para ser m&#225;s
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd espec&#237;ficos, se ha a&#241;adido un nuevo registro a la
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd estructura <code>request_rec</code>:</p>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <example>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd char *handler
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd </example>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd <p>Si quiere que su m&#243;dulo llame a un handler , solo tiene
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd que a&#241;adir <code>r-&gt;handler</code> al nombre del handler
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd en cualquier momento antes de la fase <code>invoke_handler</code>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd de la petici&#243;n. Los handlers se implementan siempre como se
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd hac&#237;a antes, aunque usando el nombre del handler en vez de un
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd tipo de contenido. Aunque no es de obligado cumplimiento, la
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd convenci&#243;n de nombres para los handlers es que se usen
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd palabras separadas por guiones, sin barras, de manera que no se
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd invada el media type name-space.</p>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd </section>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd</manualpage>
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd
41e3d6b4e67a52c6570c0412c3e5526278cf07d7nd