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 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 This file is generated from xml source: DO NOT EDIT
8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10 <title>Uso de los Handlers en Apache - Servidor HTTP Apache Versión 2.5</title>
11 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
12 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
13 <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" />
14 <script src="./style/scripts/prettify.min.js" type="text/javascript">
17 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
18 <body id="manual-page"><div id="page-header">
19 <p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/quickreference.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 del sitio web</a></p>
20 <p class="apache">Versión 2.5 del Servidor HTTP Apache</p>
21 <img alt="" src="./images/feather.png" /></div>
22 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
24 <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.5</a></div><div id="page-content"><div id="preamble"><h1>Uso de los Handlers en Apache</h1>
26 <p><span>Idiomas disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> |
27 <a href="./es/handler.html" title="Español"> es </a> |
28 <a href="./fr/handler.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
29 <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
30 <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
31 <a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
32 <a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
35 <p>Este documento describe el uso de los Handlers en Apache.</p>
37 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#definition">¿Qué es un Handler?</a></li>
38 <li><img alt="" src="./images/down.gif" /> <a href="#examples">Ejemplos</a></li>
39 <li><img alt="" src="./images/down.gif" /> <a href="#programmer">Nota para programadores</a></li>
40 </ul><h3>Consulte también</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</a></li></ul></div>
41 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
43 <h2><a name="definition" id="definition">¿Qué es un Handler?</a></h2>
45 <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 <p>Un "handler" es una representación interna de Apache de
49 una acción que se va a ejecutar cuando hay una llamada a un
50 fichero. Generalmente, los ficheros tienen handlers
51 implícitos, basados en el tipo de fichero de que se
52 trata. Normalmente, todos los ficheros son simplemente servidos
53 por el servidor, pero algunos tipos de ficheros se tratan de forma
56 <p>Handlers pueden ser usados de manera explicita,
57 basándose en la extensión del fichero o en
58 la ubicación en la que esté, se pueden especificar handlers
59 sin tener en cuenta el tipo de fichero que se trate. Esto es
60 una ventaja por dos razones. Primero, es una solución
61 más elegante. Segundo, porque a un fichero se le pueden
62 asignar tanto un tipo <strong>como</strong> un handler. (Consulte
63 también la sección <a href="mod/mod_mime.html#multipleext">Ficheros y extensiones
66 <p>Los Handlers pueden tanto ser compilados con el servidor
67 como incluidos en un módulo, o añadidos con la
68 directiva <code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code>. Los
69 handlers que vienen incluidos en el core con el servidor de la distribución
70 estándar de Apache son:</p>
73 <li><strong>default-handler</strong>: Envía el fichero
74 usando el <code>default_handler()</code>, que es el handler
75 usado por defecto para tratar contenido
78 <li><strong>send-as-is</strong>: Envía el fichero con
79 cabeceras HTTP tal y como es. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
81 <li><strong>cgi-script</strong>: Trata el fichero como un sript
82 CGI. (<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
84 <li><strong>imap-file</strong>: Trata el fichero como un mapa de
85 imágenes. (<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code>)</li>
87 <li><strong>server-info</strong>: Extrae la información de
89 servidor. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
91 <li><strong>server-status</strong>: Extrae el informe del estado
92 del servidor. (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
94 <li><strong>type-map</strong>: Trata el fichero como una
95 correspondencia de tipos para la negociación de contenidos.
96 (<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>)</li>
98 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
100 <h2><a name="examples" id="examples">Ejemplos</a></h2>
103 <h3><a name="example1" id="example1">Modificar contenido estático usando un script
107 <p>Las siguientes directivas hacen que cuando haya una
108 petición de ficheros con la extensión
109 <code>html</code> se lance el script CGI
110 <code>footer.pl</code>.</p>
112 <div class="example"><p><code>
113 Action add-footer /cgi-bin/footer.pl<br />
114 AddHandler add-footer .html
117 <p>En este caso, el script CGI es el responsable de enviar el
118 documento originalmente solicitado (contenido en la variable de
119 entorno <code>PATH_TRANSLATED</code>) y de hacer cualquier
120 modificación o añadido deseado.</p>
123 <h3><a name="example2" id="example2">Archivos con cabeceras HTTP</a></h3>
126 <p>Las siguientes directivas activan el handler
127 <code>send-as-is</code>, que se usa para ficheros que contienen
128 sus propias cabeceras HTTP. Todos los archivos en el directorio
129 <code>/web/htdocs/asis/</code> serán procesados por el
130 handler <code>send-as-is</code>, sin tener en cuenta su
133 <pre class="prettyprint lang-config"><Directory "/web/htdocs/asis">
134 SetHandler send-as-is
135 </Directory></pre>
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>
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>
150 <pre class="prettyprint lang-c">char *handler</pre>
153 <p>Si quiere que su módulo llame a un handler , solo tiene
154 que añadir <code>r->handler</code> al nombre del handler
155 en cualquier momento antes de la fase <code>invoke_handler</code>
156 de la petición. Los handlers se implementan siempre como se
157 hacía antes, aunque usando el nombre del handler en vez de un
158 tipo de contenido. Aunque no es de obligado cumplimiento, la
159 convención de nombres para los handlers es que se usen
160 palabras separadas por guiones, sin barras, de manera que no se
161 invada el media type name-space.</p>
163 <div class="bottomlang">
164 <p><span>Idiomas disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> |
165 <a href="./es/handler.html" title="Español"> es </a> |
166 <a href="./fr/handler.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
167 <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
168 <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
169 <a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
170 <a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
171 </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>
172 <script type="text/javascript"><!--//--><![CDATA[//><!--
173 var comments_shortname = 'httpd';
174 var comments_identifier = 'http://httpd.apache.org/docs/trunk/handler.html';
176 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
177 d.write('<div id="comments_thread"><\/div>');
178 var s = d.createElement('script');
179 s.type = 'text/javascript';
181 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
182 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
185 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
187 })(window, document);
188 //--><!]]></script></div><div id="footer">
189 <p class="apache">Copyright 2016 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>
190 <p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/quickreference.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 del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
191 if (typeof(prettyPrint) !== 'undefined') {