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