handler.xml.es revision 72e8608f7c9ded75dc1c040517767943607f54f4
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd<?xml-stylesheet type="text/xsl" href="/style/manual.es.xsl"?>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd<!-- English Revision: 103425 -->
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd Copyright 2004 The Apache Software Foundation
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd Licensed under the Apache License, Version 2.0 (the "License");
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd you may not use this file except in compliance with the License.
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd You may obtain a copy of the License at
27e52281f1522522b170cafc76b08b58aa70ccaand Unless required by applicable law or agreed to in writing, software
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd distributed under the License is distributed on an "AS IS" BASIS,
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd See the License for the specific language governing permissions and
4b5981e276e93df97c34e4da05ca5cf8bbd937dand limitations under the License.
ecc5150d35c0dc5ee5119c2717e6660fa331abbftakashi <p>Este documento describe el uso de los Handlers en Apache.</p>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd </summary>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd <modulelist>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd </modulelist>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd <directivelist>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd </directivelist>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd </related>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd <p>Un "handler" es una representación interna de Apache de
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd una acción que se va a ejecutar cuando hay una llamada a un
316f02e3836836c82e19019ff23f90a7ebc65289nilgun fichero. Generalmente, los ficheros tienen handlers
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd implícitos, basados en el tipo de fichero de que se
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd trata. Normalmente, todos los ficheros son simplemente servidos
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd por el servidor, pero algunos tipos de ficheros se tratan de forma
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd diferente.</p>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd <p>Apache 1.1 añade la posibilidad de usar handlers
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd explicitamente. Basándose en la extension del fichero o en
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd la ubicación en la que este, se pueden especificar handlers
08cf4a15275e4cb65a424b3a1db5410bfb51085cjim sin tener en cuenta el tipo de fichero de que se trate. Esto es
22d5d84393d960a2027f472036f3fee15d7dbce9nd una ventaja por dos razones. Primero, es una solución
22d5d84393d960a2027f472036f3fee15d7dbce9nd más elegante. Segundo, porque a un fichero se le pueden
22d5d84393d960a2027f472036f3fee15d7dbce9nd asignar tanto un tipo <strong>como</strong> un handler. (Consulte
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd también la sección <a
a78048ccbdb6256da15e6b0e7e95355e480c2301nd href="mod/mod_mime.html#multipleext">Ficheros y extensiones
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd <p>Los Handlers pueden ser tanto ser compilados con el servidor
a78048ccbdb6256da15e6b0e7e95355e480c2301nd como incluidos en un módulo, como añadidos con la
623eebe956d9c2d6d073ed3eae855b56030b40e9noodl directiva <directive module="mod_actions">Action</directive>. Los
a78048ccbdb6256da15e6b0e7e95355e480c2301nd handlers compilados con el servidor de la distribución
a78048ccbdb6256da15e6b0e7e95355e480c2301nd estándar de Apache son:</p>
a78048ccbdb6256da15e6b0e7e95355e480c2301nd <li><strong>default-handler</strong>: Envía el fichero
a78048ccbdb6256da15e6b0e7e95355e480c2301nd usando el <code>default_handler()</code>, que es el handler
42af92a661a06b3cebc88d585aad75064a309d51nd usado por defecto para tratar contenido
42af92a661a06b3cebc88d585aad75064a309d51nd estático. (core)</li>
6fe26506780e73be2a412d758af77fafdf03291and <li><strong>send-as-is</strong>: Envía el fichero con
a78048ccbdb6256da15e6b0e7e95355e480c2301nd cabeceras HTTP tal y como es. (<module>mod_asis</module>)</li>
9649d29bb7801e0698e6a845e1a8a61534df58b3noodl <li><strong>cgi-script</strong>: Trata el fichero como un sript
a78048ccbdb6256da15e6b0e7e95355e480c2301nd <li><strong>imap-file</strong>: Trata el fichero como un mapa de
08cf4a15275e4cb65a424b3a1db5410bfb51085cjim <li><strong>server-info</strong>: Extrae la información de
6aadbc6fd703e73d1d419e9f06b84a4338c898f1maczniak configuración del
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd <li><strong>server-status</strong>: Extrae el informe de estado
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd correspondencia de tipos para la negociación de contenidos.
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd <title>Modificar contenido estático usando un script
611049e38bfbaeb173d2d7fab2e44a48753436a1nd CGI</title>
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd <p>Las siguientes directivas hacen que cuando haya una
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd petición de ficheros con la extensión
a78048ccbdb6256da15e6b0e7e95355e480c2301nd AddHandler add-footer .html
03a4ff9ac4c9b8009249010e7c53bb86ff05915and </example>
d0828c8a321dc5e9ea60550f052294669c08cf93jim <p>En este caso, el script CGI es el responsable de enviar el
d0828c8a321dc5e9ea60550f052294669c08cf93jim documento originalmente solicitado (contenido en la variable de
f21bea4c0f58e17aa1d9a0fac2c219852f89944amaczniak entorno <code>PATH_TRANSLATED</code>) y de hacer cualquier
4b5981e276e93df97c34e4da05ca5cf8bbd937dand modificación o añadido deseado.</p>
2704de98885368683621b01c8f8f4e4b01557611takashi <p>Las siguientes directivas activan el handler
d0828c8a321dc5e9ea60550f052294669c08cf93jim <code>send-as-is</code>, que se usa para ficheros que contienen
2704de98885368683621b01c8f8f4e4b01557611takashi sus propias cabeceras HTTP. Todos los archivos en el directorio
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd <code>/web/htdocs/asis/</code> serán procesados por el
6aadbc6fd703e73d1d419e9f06b84a4338c898f1maczniak handler <code>send-as-is</code>, sin tener en cuenta su
d2b809e5d72658bff23819d8b77f20e4939af541nd extension.</p>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd SetHandler send-as-is<br/>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd </Directory>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd </example>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd </section>
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd </section>
a43bfa789f4e52dde53ae8e53fa0427b5c1cf977nd <p>Para implementar las funcionalidades de los handlers, se ha
a43bfa789f4e52dde53ae8e53fa0427b5c1cf977nd hecho un añadido a la <a href="developer/API.html">API de
28c9d384aa958b321280b4ac886941dcad25396bnd Apache</a> que puede que quiera usar. Para ser más
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd específicos, se ha añadido un nuevo registro a la
604c89126c27104f659d7a51b0113e3bd435faf8fielding char *handler
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd <p>Si quiere que su módulo llame a un handler , solo tiene
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd que añadir <code>r->handler</code> al nombre del handler
0853e1e2522c1ac17f697221758bcbd4781a7ff9nd en cualquier momento antes de la fase <code>invoke_handler</code>
0a69d9bb491d9810892a9949c01403a1de3c7ac2nd de la petición. Los handlers se implementan siempre como se
5f4e50966b2b9b58436a1651cbe588d1b595657ewrowe hacía antes, aunque usando el nombre del handler en vez de un
5f4e50966b2b9b58436a1651cbe588d1b595657ewrowe tipo de contenido. Aunque no es de obligado cumplimiento, la
5f4e50966b2b9b58436a1651cbe588d1b595657ewrowe convención de nombres para los handlers es que se usen
5f4e50966b2b9b58436a1651cbe588d1b595657ewrowe palabras separadas por guiones, sin barras, de manera que no se
11495c9f0bd33e51a25b4d532beadfbcf9b944a3nilgun invada el media type name-space.</p>
5f4e50966b2b9b58436a1651cbe588d1b595657ewrowe</manualpage>