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> |
  27 <a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese">&nbsp;zh-cn&nbsp;</a></p>
  28 </div>
  29 <div class="outofdate">Esta traducción podría estar
  30             obsoleta. Consulte la versión en inglés de la
  31             documentación para comprobar si se han producido cambios
  32             recientemente.</div>
  33
  34     <p>Este documento describe el uso de los Handlers en Apache.</p>
  35   </div>
  36 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#definition">¿Qué es un Handler?</a></li>
  37 <li><img alt="" src="./images/down.gif" /> <a href="#examples">Ejemplos</a></li>
  38 <li><img alt="" src="./images/down.gif" /> <a href="#programmer">Nota para programadores</a></li>
  39 </ul></div>
  40 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  41 <div class="section">
  42 <h2><a name="definition" id="definition">¿Qué es un Handler?</a></h2>
  43
  44     <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>
  45
  46
  47     <p>Un "handler" es una representación interna de Apache de
  48     una acción que se va a ejecutar cuando hay una llamada a un
  49     fichero. Generalmente, los ficheros tienen handlers
  50     implícitos, basados en el tipo de fichero de que se
  51     trata. Normalmente, todos los ficheros son simplemente servidos
  52     por el servidor, pero algunos tipos de ficheros se tratan de forma
  53     diferente.</p>
  54
  55     <p>Apache 1.1 añade la posibilidad de usar handlers
  56     explicitamente.  Basándose en la extension del fichero o en
  57     la ubicación en la que este, se pueden especificar handlers
  58     sin tener en cuenta el tipo de fichero de que se trate. Esto es
  59     una ventaja por dos razones. Primero, es una solución
  60     más elegante. Segundo, porque a un fichero se le pueden
  61     asignar tanto un tipo <strong>como</strong> un handler. (Consulte
  62     también la sección <a href="mod/mod_mime.html#multipleext">Ficheros y extensiones
  63     múltiples</a>.)</p>
  64
  65     <p>Los Handlers pueden ser tanto ser compilados con el servidor
  66     como incluidos en un módulo, como añadidos con la
  67     directiva <code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code>. Los
  68     handlers compilados con el servidor de la distribución
  69     estándar de Apache son:</p>
  70
  71     <ul>
  72       <li><strong>default-handler</strong>: Envía el fichero
  73       usando el <code>default_handler()</code>, que es el handler
  74       usado por defecto para tratar contenido
  75       estático. (core)</li>
  76
  77       <li><strong>send-as-is</strong>: Envía el fichero con
  78       cabeceras HTTP tal y como es. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
  79
  80       <li><strong>cgi-script</strong>: Trata el fichero como un sript
  81       CGI. (<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
  82
  83       <li><strong>imap-file</strong>: Trata el fichero como un mapa de
  84       imágenes. (<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code>)</li>
  85
  86       <li><strong>server-info</strong>: Extrae la información de
  87       configuración del
  88       servidor. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
  89
  90       <li><strong>server-status</strong>: Extrae el informe de estado
  91       del servidor. (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
  92
  93       <li><strong>type-map</strong>: Trata el fichero como una
  94       correspondencia de tipos para la negociación de contenidos.
  95       (<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>
  96 <div class="section">
  97 <h2><a name="examples" id="examples">Ejemplos</a></h2>
  98
  99     <h3><a name="example1" id="example1">Modificar contenido estático usando un script
 100       CGI</a></h3>
 101
 102
 103       <p>Las siguientes directivas hacen que cuando haya una
 104       petición de ficheros con la extensión
 105       <code>html</code> se lance el script CGI
 106       <code>footer.pl</code>.</p>
 107
 108       <div class="example"><p><code>
 109         Action add-footer /cgi-bin/footer.pl<br />
 110         AddHandler add-footer .html
 111       </code></p></div>
 112
 113       <p>En este caso, el script CGI es el responsable de enviar el
 114       documento originalmente solicitado (contenido en la variable de
 115       entorno <code>PATH_TRANSLATED</code>) y de hacer cualquier
 116       modificación o añadido deseado.</p>
 117
 118
 119     <h3><a name="example2" id="example2">Archivos con cabaceras HTTP</a></h3>
 120
 121
 122       <p>Las siguientes directivas activan el handler
 123       <code>send-as-is</code>, que se usa para ficheros que contienen
 124       sus propias cabeceras HTTP. Todos los archivos en el directorio
 125       <code>/web/htdocs/asis/</code> serán procesados por el
 126       handler <code>send-as-is</code>, sin tener en cuenta su
 127       extension.</p>
 128
 129       <div class="example"><p><code>
 130         &lt;Directory /web/htdocs/asis&gt;<br />
 131         SetHandler send-as-is<br />
 132         &lt;/Directory&gt;
 133       </code></p></div>
 134
 135
 136   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 137 <div class="section">
 138 <h2><a name="programmer" id="programmer">Nota para programadores</a></h2>
 139
 140
 141     <p>Para implementar las funcionalidades de los handlers, se ha
 142     hecho un añadido a la <a href="developer/API.html">API de
 143     Apache</a> que puede que quiera usar. Para ser más
 144     específicos, se ha añadido un nuevo registro a la
 145     estructura <code>request_rec</code>:</p>
 146
 147     <div class="example"><p><code>
 148       char *handler
 149     </code></p></div>
 150
 151     <p>Si quiere que su módulo llame a un handler , solo tiene
 152     que añadir <code>r-&gt;handler</code> al nombre del handler
 153     en cualquier momento antes de la fase <code>invoke_handler</code>
 154     de la petición. Los handlers se implementan siempre como se
 155     hacía antes, aunque usando el nombre del handler en vez de un
 156     tipo de contenido. Aunque no es de obligado cumplimiento, la
 157     convención de nombres para los handlers es que se usen
 158     palabras separadas por guiones, sin barras, de manera que no se
 159     invada el media type name-space.</p>
 160   </div></div>
 161 <div class="bottomlang">
 162 <p><span>Idiomas disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 163 <a href="./es/handler.html" title="Español">&nbsp;es&nbsp;</a> |
 164 <a href="./fr/handler.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 165 <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 166 <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 167 <a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a> |
 168 <a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese">&nbsp;zh-cn&nbsp;</a></p>
 169 </div><div id="footer">
 170 <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>
 171 <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>
 172 </body></html>