handler.html.es revision 27e52281f1522522b170cafc76b08b58aa70ccaa
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="es" xml:lang="es"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Uso de los Handlers en Apache - Servidor HTTP Apache</title>
<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="/images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<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>
<p class="apache">Versi�n 2.3 del Servidor HTTP Apache</p>
<img alt="" src="/images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
<div id="path">
<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.3</a></div><div id="page-content"><div id="preamble"><h1>Uso de los Handlers en Apache</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="/en/handler.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="/es/handler.html" title="Espa�ol">&nbsp;es&nbsp;</a> |
<a href="/ja/handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/ko/handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div>
<div class="outofdate">Esta traducci�n podr�a estar
obsoleta. Consulte la versi�n en ingl�s de la
documentaci�n para comprobar si se han producido cambios
recientemente.</div>
<p>Este documento describe el uso de los Handlers en Apache.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#definition">�Qu� es un Handler?</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#examples">Ejemplos</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#programmer">Nota para programadores</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="definition" id="definition">�Qu� es un Handler?</a></h2>
<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>
<p>Un "handler" es una representaci�n interna de Apache de
una acci�n que se va a ejecutar cuando hay una llamada a un
fichero. Generalmente, los ficheros tienen handlers
impl�citos, basados en el tipo de fichero de que se
trata. Normalmente, todos los ficheros son simplemente servidos
por el servidor, pero algunos tipos de ficheros se tratan de forma
diferente.</p>
<p>Apache 1.1 a�ade la posibilidad de usar handlers
explicitamente. Bas�ndose en la extension del fichero o en
la ubicaci�n en la que este, se pueden especificar handlers
sin tener en cuenta el tipo de fichero de que se trate. Esto es
una ventaja por dos razones. Primero, es una soluci�n
m�s elegante. Segundo, porque a un fichero se le pueden
asignar tanto un tipo <strong>como</strong> un handler. (Consulte
tambi�n la secci�n <a href="mod/mod_mime.html#multipleext">Ficheros y extensiones
m�ltiples</a>.)</p>
<p>Los Handlers pueden ser tanto ser compilados con el servidor
como incluidos en un m�dulo, como a�adidos con la
directiva <code class="directive"><a href="/mod/mod_actions.html#action">Action</a></code>. Los
handlers compilados con el servidor de la distribuci�n
est�ndar de Apache son:</p>
<ul>
<li><strong>default-handler</strong>: Env�a el fichero
usando el <code>default_handler()</code>, que es el handler
usado por defecto para tratar contenido
est�tico. (core)</li>
<li><strong>send-as-is</strong>: Env�a el fichero con
cabeceras HTTP tal y como es. (<code class="module"><a href="/mod/mod_asis.html">mod_asis</a></code>)</li>
<li><strong>cgi-script</strong>: Trata el fichero como un sript
CGI. (<code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code>)</li>
<li><strong>imap-file</strong>: Trata el fichero como un mapa de
im�genes. (<code class="module"><a href="/mod/mod_imap.html">mod_imap</a></code>)</li>
<li><strong>server-info</strong>: Extrae la informaci�n de
configuraci�n del
servidor. (<code class="module"><a href="/mod/mod_info.html">mod_info</a></code>)</li>
<li><strong>server-status</strong>: Extrae el informe de estado
del servidor. (<code class="module"><a href="/mod/mod_status.html">mod_status</a></code>)</li>
<li><strong>type-map</strong>: Trata el fichero como una
correspondencia de tipos para la negociaci�n de contenidos.
(<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>
<div class="section">
<h2><a name="examples" id="examples">Ejemplos</a></h2>
<h3><a name="example1" id="example1">Modificar contenido est�tico usando un script
CGI</a></h3>
<p>Las siguientes directivas hacen que cuando haya una
petici�n de ficheros con la extensi�n
<code>html</code> se lance el script CGI
<code>footer.pl</code>.</p>
<div class="example"><p><code>
Action add-footer /cgi-bin/footer.pl<br />
AddHandler add-footer .html
</code></p></div>
<p>En este caso, el script CGI es el responsable de enviar el
documento originalmente solicitado (contenido en la variable de
entorno <code>PATH_TRANSLATED</code>) y de hacer cualquier
modificaci�n o a�adido deseado.</p>
<h3><a name="example2" id="example2">Archivos con cabaceras HTTP</a></h3>
<p>Las siguientes directivas activan el handler
<code>send-as-is</code>, que se usa para ficheros que contienen
sus propias cabeceras HTTP. Todos los archivos en el directorio
<code>/web/htdocs/asis/</code> ser�n procesados por el
handler <code>send-as-is</code>, sin tener en cuenta su
extension.</p>
<div class="example"><p><code>
&lt;Directory /web/htdocs/asis&gt;<br />
SetHandler send-as-is<br />
&lt;/Directory&gt;
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="programmer" id="programmer">Nota para programadores</a></h2>
<p>Para implementar las funcionalidades de los handlers, se ha
hecho un a�adido a la <a href="developer/API.html">API de
Apache</a> que puede que quiera usar. Para ser m�s
espec�ficos, se ha a�adido un nuevo registro a la
estructura <code>request_rec</code>:</p>
<div class="example"><p><code>
char *handler
</code></p></div>
<p>Si quiere que su m�dulo llame a un handler , solo tiene
que a�adir <code>r-&gt;handler</code> al nombre del handler
en cualquier momento antes de la fase <code>invoke_handler</code>
de la petici�n. Los handlers se implementan siempre como se
hac�a antes, aunque usando el nombre del handler en vez de un
tipo de contenido. Aunque no es de obligado cumplimiento, la
convenci�n de nombres para los handlers es que se usen
palabras separadas por guiones, sin barras, de manera que no se
invada el media type name-space.</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="/en/handler.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="/es/handler.html" title="Espa�ol">&nbsp;es&nbsp;</a> |
<a href="/ja/handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/ko/handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer">
<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>
<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>
</body></html>