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" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" /> 12<script src="/style/scripts/prettify.min.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body id="manual-page"><div id="page-header"> 17<p class="menu"><a href="/mod/">M�dulos</a> | <a href="/mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="/glossary.html">Glosario</a> | <a href="/sitemap.html">Mapa de este sitio web</a></p> 18<p class="apache">Versi�n 2.4 del Servidor HTTP Apache</p> 19<img alt="" src="/images/feather.gif" /></div> 20<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 21<div id="path"> 22<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentaci�n</a> > <a href="./">Versi�n 2.4</a></div><div id="page-content"><div id="preamble"><h1>Uso de los Handlers en Apache</h1> 23<div class="toplang"> 24<p><span>Idiomas disponibles: </span><a href="/en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> | 25<a href="/es/handler.html" title="Espa�ol"> es </a> | 26<a href="/fr/handler.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> | 27<a href="/ja/handler.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 28<a href="/ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 29<a href="/tr/handler.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a> | 30<a href="/zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> 31</div> 32<div class="outofdate">Esta traducci�n podr�a estar 33 obsoleta. Consulte la versi�n en ingl�s de la 34 documentaci�n para comprobar si se han producido cambios 35 recientemente.</div> 36 37 <p>Este documento describe el uso de los Handlers en Apache.</p> 38 </div> 39<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#definition">�Qu� es un Handler?</a></li> 40<li><img alt="" src="/images/down.gif" /> <a href="#examples">Ejemplos</a></li> 41<li><img alt="" src="/images/down.gif" /> <a href="#programmer">Nota para programadores</a></li> 42</ul><ul class="seealso"><li><a href="#comments_section">Comentarios</a></li></ul></div> 43<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 44<div class="section"> 45<h2><a name="definition" id="definition">�Qu� es un Handler?</a></h2> 46 47 <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> 48 49 50 <p>Un "handler" es una representaci�n interna de Apache de 51 una acci�n que se va a ejecutar cuando hay una llamada a un 52 fichero. Generalmente, los ficheros tienen handlers 53 impl�citos, basados en el tipo de fichero de que se 54 trata. Normalmente, todos los ficheros son simplemente servidos 55 por el servidor, pero algunos tipos de ficheros se tratan de forma 56 diferente.</p> 57 58 <p>Apache 1.1 a�ade la posibilidad de usar handlers 59 explicitamente. Bas�ndose en la extension del fichero o en 60 la ubicaci�n en la que este, se pueden especificar handlers 61 sin tener en cuenta el tipo de fichero de que se trate. Esto es 62 una ventaja por dos razones. Primero, es una soluci�n 63 m�s elegante. Segundo, porque a un fichero se le pueden 64 asignar tanto un tipo <strong>como</strong> un handler. (Consulte 65 tambi�n la secci�n <a href="mod/mod_mime.html#multipleext">Ficheros y extensiones 66 m�ltiples</a>.)</p> 67 68 <p>Los Handlers pueden ser tanto ser compilados con el servidor 69 como incluidos en un m�dulo, como a�adidos con la 70 directiva <code class="directive"><a href="/mod/mod_actions.html#action">Action</a></code>. Los 71 handlers compilados con el servidor de la distribuci�n 72 est�ndar de Apache son:</p> 73 74 <ul> 75 <li><strong>default-handler</strong>: Env�a el fichero 76 usando el <code>default_handler()</code>, que es el handler 77 usado por defecto para tratar contenido 78 est�tico. (core)</li> 79 80 <li><strong>send-as-is</strong>: Env�a el fichero con 81 cabeceras HTTP tal y como es. (<code class="module"><a href="/mod/mod_asis.html">mod_asis</a></code>)</li> 82 83 <li><strong>cgi-script</strong>: Trata el fichero como un sript 84 CGI. (<code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code>)</li> 85 86 <li><strong>imap-file</strong>: Trata el fichero como un mapa de 87 im�genes. (<code class="module"><a href="/mod/mod_imagemap.html">mod_imagemap</a></code>)</li> 88 89 <li><strong>server-info</strong>: Extrae la informaci�n de 90 configuraci�n del 91 servidor. (<code class="module"><a href="/mod/mod_info.html">mod_info</a></code>)</li> 92 93 <li><strong>server-status</strong>: Extrae el informe de estado 94 del servidor. (<code class="module"><a href="/mod/mod_status.html">mod_status</a></code>)</li> 95 96 <li><strong>type-map</strong>: Trata el fichero como una 97 correspondencia de tipos para la negociaci�n de contenidos. 98 (<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> 99<div class="section"> 100<h2><a name="examples" id="examples">Ejemplos</a></h2> 101 102 <h3><a name="example1" id="example1">Modificar contenido est�tico usando un script 103 CGI</a></h3> 104 105 106 <p>Las siguientes directivas hacen que cuando haya una 107 petici�n de ficheros con la extensi�n 108 <code>html</code> se lance el script CGI 109 <code>footer.pl</code>.</p> 110 111 <div class="example"><p><code> 112 Action add-footer /cgi-bin/footer.pl<br /> 113 AddHandler add-footer .html 114 </code></p></div> 115 116 <p>En este caso, el script CGI es el responsable de enviar el 117 documento originalmente solicitado (contenido en la variable de 118 entorno <code>PATH_TRANSLATED</code>) y de hacer cualquier 119 modificaci�n o a�adido deseado.</p> 120 121 122 <h3><a name="example2" id="example2">Archivos con cabaceras HTTP</a></h3> 123 124 125 <p>Las siguientes directivas activan el handler 126 <code>send-as-is</code>, que se usa para ficheros que contienen 127 sus propias cabeceras HTTP. Todos los archivos en el directorio 128 <code>/web/htdocs/asis/</code> ser�n procesados por el 129 handler <code>send-as-is</code>, sin tener en cuenta su 130 extension.</p> 131 132 <div class="example"><p><code> 133 <Directory /web/htdocs/asis><br /> 134 SetHandler send-as-is<br /> 135 </Directory> 136 </code></p></div> 137 138 139 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 140<div class="section"> 141<h2><a name="programmer" id="programmer">Nota para programadores</a></h2> 142 143 144 <p>Para implementar las funcionalidades de los handlers, se ha 145 hecho un a�adido a la <a href="developer/API.html">API de 146 Apache</a> que puede que quiera usar. Para ser m�s 147 espec�ficos, se ha a�adido un nuevo registro a la 148 estructura <code>request_rec</code>:</p> 149 150 <div class="example"><p><code> 151 char *handler 152 </code></p></div> 153 154 <p>Si quiere que su m�dulo llame a un handler , solo tiene 155 que a�adir <code>r->handler</code> al nombre del handler 156 en cualquier momento antes de la fase <code>invoke_handler</code> 157 de la petici�n. Los handlers se implementan siempre como se 158 hac�a antes, aunque usando el nombre del handler en vez de un 159 tipo de contenido. Aunque no es de obligado cumplimiento, la 160 convenci�n de nombres para los handlers es que se usen 161 palabras separadas por guiones, sin barras, de manera que no se 162 invada el media type name-space.</p> 163 </div></div> 164<div class="bottomlang"> 165<p><span>Idiomas disponibles: </span><a href="/en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> | 166<a href="/es/handler.html" title="Espa�ol"> es </a> | 167<a href="/fr/handler.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> | 168<a href="/ja/handler.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 169<a href="/ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 170<a href="/tr/handler.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a> | 171<a href="/zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> 172</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> 173<script type="text/javascript"><!--//--><![CDATA[//><!-- 174var comments_shortname = 'httpd'; 175var comments_identifier = 'http://httpd.apache.org/docs/2.4/handler.html'; 176(function(w, d) { 177 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 178 d.write('<div id="comments_thread"><\/div>'); 179 var s = d.createElement('script'); 180 s.type = 'text/javascript'; 181 s.async = true; 182 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 183 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 184 } 185 else { 186 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 187 } 188})(window, document); 189//--><!]]></script></div><div id="footer"> 190<p class="apache">Copyright 2014 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> 191<p class="menu"><a href="/mod/">M�dulos</a> | <a href="/mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="/glossary.html">Glosario</a> | <a href="/sitemap.html">Mapa de este sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 192if (typeof(prettyPrint) !== 'undefined') { 193 prettyPrint(); 194} 195//--><!]]></script> 196</body></html>