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