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