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