granicus.if.org Git - apache/blob - docs/manual/handler.html.es

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="es" xml:lang="es"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>Uso de los Handlers en Apache - Servidor HTTP Apache</title>
   9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
  13 <body id="manual-page"><div id="page-header">
  14 <p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="./faq/">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa de este sitio web</a></p>
  15 <p class="apache">Versión 2.3 del Servidor HTTP Apache</p>
  16 <img alt="" src="./images/feather.gif" /></div>
  17 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
  18 <div id="path">
  19 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Servidor HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentación</a> &gt; <a href="./">Versión 2.3</a></div><div id="page-content"><div id="preamble"><h1>Uso de los Handlers en Apache</h1>
  20 <div class="toplang">
  21 <p><span>Idiomas disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  22 <a href="./es/handler.html" title="Español">&nbsp;es&nbsp;</a> |
  23 <a href="./fr/handler.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  24 <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  25 <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  26 <a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  27 </div>
  28 <div class="outofdate">Esta traducción podría estar
  29             obsoleta. Consulte la versión en inglés de la
  30             documentación para comprobar si se han producido cambios
  31             recientemente.</div>
  32
  33     <p>Este documento describe el uso de los Handlers en Apache.</p>
  34   </div>
  35 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#definition">¿Qué es un Handler?</a></li>
  36 <li><img alt="" src="./images/down.gif" /> <a href="#examples">Ejemplos</a></li>
  37 <li><img alt="" src="./images/down.gif" /> <a href="#programmer">Nota para programadores</a></li>
  38 </ul></div>
  39 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  40 <div class="section">
  41 <h2><a name="definition" id="definition">¿Qué es un Handler?</a></h2>
  42
  43     <table class="related"><tr><th>Módulos Relacionados</th><th>Directivas Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_actions.html">mod_actions</a></code></li><li><code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code></li><li><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></li><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li><li><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></li><li><code class="module"><a href="./mod/mod_status.html">mod_status</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removehandler">RemoveHandler</a></code></li><li><code class="directive"><a href="./mod/core.html#sethandler">SetHandler</a></code></li></ul></td></tr></table>
  44
  45
  46     <p>Un "handler" es una representación interna de Apache de
  47     una acción que se va a ejecutar cuando hay una llamada a un
  48     fichero. Generalmente, los ficheros tienen handlers
  49     implícitos, basados en el tipo de fichero de que se
  50     trata. Normalmente, todos los ficheros son simplemente servidos
  51     por el servidor, pero algunos tipos de ficheros se tratan de forma
  52     diferente.</p>
  53
  54     <p>Apache 1.1 añade la posibilidad de usar handlers
  55     explicitamente.  Basándose en la extension del fichero o en
  56     la ubicación en la que este, se pueden especificar handlers
  57     sin tener en cuenta el tipo de fichero de que se trate. Esto es
  58     una ventaja por dos razones. Primero, es una solución
  59     más elegante. Segundo, porque a un fichero se le pueden
  60     asignar tanto un tipo <strong>como</strong> un handler. (Consulte
  61     también la sección <a href="mod/mod_mime.html#multipleext">Ficheros y extensiones
  62     múltiples</a>.)</p>
  63
  64     <p>Los Handlers pueden ser tanto ser compilados con el servidor
  65     como incluidos en un módulo, como añadidos con la
  66     directiva <code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code>. Los
  67     handlers compilados con el servidor de la distribución
  68     estándar de Apache son:</p>
  69
  70     <ul>
  71       <li><strong>default-handler</strong>: Envía el fichero
  72       usando el <code>default_handler()</code>, que es el handler
  73       usado por defecto para tratar contenido
  74       estático. (core)</li>
  75
  76       <li><strong>send-as-is</strong>: Envía el fichero con
  77       cabeceras HTTP tal y como es. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
  78
  79       <li><strong>cgi-script</strong>: Trata el fichero como un sript
  80       CGI. (<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
  81
  82       <li><strong>imap-file</strong>: Trata el fichero como un mapa de
  83       imágenes. (<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code>)</li>
  84
  85       <li><strong>server-info</strong>: Extrae la información de
  86       configuración del
  87       servidor. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
  88
  89       <li><strong>server-status</strong>: Extrae el informe de estado
  90       del servidor. (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
  91
  92       <li><strong>type-map</strong>: Trata el fichero como una
  93       correspondencia de tipos para la negociación de contenidos.
  94       (<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>)</li> </ul> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  95 <div class="section">
  96 <h2><a name="examples" id="examples">Ejemplos</a></h2>
  97
  98     <h3><a name="example1" id="example1">Modificar contenido estático usando un script
  99       CGI</a></h3>
 100
 101
 102       <p>Las siguientes directivas hacen que cuando haya una
 103       petición de ficheros con la extensión
 104       <code>html</code> se lance el script CGI
 105       <code>footer.pl</code>.</p>
 106
 107       <div class="example"><p><code>
 108         Action add-footer /cgi-bin/footer.pl<br />
 109         AddHandler add-footer .html
 110       </code></p></div>
 111
 112       <p>En este caso, el script CGI es el responsable de enviar el
 113       documento originalmente solicitado (contenido en la variable de
 114       entorno <code>PATH_TRANSLATED</code>) y de hacer cualquier
 115       modificación o añadido deseado.</p>
 116
 117
 118     <h3><a name="example2" id="example2">Archivos con cabaceras HTTP</a></h3>
 119
 120
 121       <p>Las siguientes directivas activan el handler
 122       <code>send-as-is</code>, que se usa para ficheros que contienen
 123       sus propias cabeceras HTTP. Todos los archivos en el directorio
 124       <code>/web/htdocs/asis/</code> serán procesados por el
 125       handler <code>send-as-is</code>, sin tener en cuenta su
 126       extension.</p>
 127
 128       <div class="example"><p><code>
 129         &lt;Directory /web/htdocs/asis&gt;<br />
 130         SetHandler send-as-is<br />
 131         &lt;/Directory&gt;
 132       </code></p></div>
 133
 134
 135   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 136 <div class="section">
 137 <h2><a name="programmer" id="programmer">Nota para programadores</a></h2>
 138
 139
 140     <p>Para implementar las funcionalidades de los handlers, se ha
 141     hecho un añadido a la <a href="developer/API.html">API de
 142     Apache</a> que puede que quiera usar. Para ser más
 143     específicos, se ha añadido un nuevo registro a la
 144     estructura <code>request_rec</code>:</p>
 145
 146     <div class="example"><p><code>
 147       char *handler
 148     </code></p></div>
 149
 150     <p>Si quiere que su módulo llame a un handler , solo tiene
 151     que añadir <code>r-&gt;handler</code> al nombre del handler
 152     en cualquier momento antes de la fase <code>invoke_handler</code>
 153     de la petición. Los handlers se implementan siempre como se
 154     hacía antes, aunque usando el nombre del handler en vez de un
 155     tipo de contenido. Aunque no es de obligado cumplimiento, la
 156     convención de nombres para los handlers es que se usen
 157     palabras separadas por guiones, sin barras, de manera que no se
 158     invada el media type name-space.</p>
 159   </div></div>
 160 <div class="bottomlang">
 161 <p><span>Idiomas disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 162 <a href="./es/handler.html" title="Español">&nbsp;es&nbsp;</a> |
 163 <a href="./fr/handler.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 164 <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 165 <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 166 <a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 167 </div><div id="footer">
 168 <p class="apache">Copyright 2011 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 169 <p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="./faq/">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa de este sitio web</a></p></div>
 170 </body></html>