rubbos/app/httpd-2.0.64/docs/manual/mod/core.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>core - 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>
  14 <div id="page-header">
  15 <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>
  16 <p class="apache">Versión 2.0 del Servidor HTTP Apache</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <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> &gt; <a href="./">Módulos</a></div>
  21 <div id="page-content">
  22 <div id="preamble"><h1>Funcionalidad Básica de Apache</h1>
  23 <div class="toplang">
  24 <p><span>Idiomas disponibles: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
  25 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  26 <a href="../es/mod/core.html" title="Español">&nbsp;es&nbsp;</a> |
  27 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  28 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  29 </div>
  30 <div class="outofdate">Esta traducción podría estar
  31             obsoleta. Consulte la versión en inglés de la
  32             documentación para comprobar si se han producido cambios
  33             recientemente.</div>
  34 <table class="module"><tr><th><a href="module-dict.html#Description">Descripción:</a></th><td>Funcionalidades básicas del servidor HTTP Apache que
  35 están siempre presentes</td></tr>
  36 <tr><th><a href="module-dict.html#Status">Estado:</a></th><td>Core</td></tr></table>
  37 </div>
  38 <div id="quickview"><h3 class="directives">Directivas</h3>
  39 <ul id="toc">
  40 <li><img alt="" src="../images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
  41 <li><img alt="" src="../images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
  42 <li><img alt="" src="../images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
  43 <li><img alt="" src="../images/down.gif" /> <a href="#addoutputfilterbytype">AddOutputFilterByType</a></li>
  44 <li><img alt="" src="../images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
  45 <li><img alt="" src="../images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
  46 <li><img alt="" src="../images/down.gif" /> <a href="#authname">AuthName</a></li>
  47 <li><img alt="" src="../images/down.gif" /> <a href="#authtype">AuthType</a></li>
  48 <li><img alt="" src="../images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
  49 <li><img alt="" src="../images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
  50 <li><img alt="" src="../images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
  51 <li><img alt="" src="../images/down.gif" /> <a href="#directory">&lt;Directory&gt;</a></li>
  52 <li><img alt="" src="../images/down.gif" /> <a href="#directorymatch">&lt;DirectoryMatch&gt;</a></li>
  53 <li><img alt="" src="../images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
  54 <li><img alt="" src="../images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
  55 <li><img alt="" src="../images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
  56 <li><img alt="" src="../images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
  57 <li><img alt="" src="../images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
  58 <li><img alt="" src="../images/down.gif" /> <a href="#fileetag">FileETag</a></li>
  59 <li><img alt="" src="../images/down.gif" /> <a href="#files">&lt;Files&gt;</a></li>
  60 <li><img alt="" src="../images/down.gif" /> <a href="#filesmatch">&lt;FilesMatch&gt;</a></li>
  61 <li><img alt="" src="../images/down.gif" /> <a href="#forcetype">ForceType</a></li>
  62 <li><img alt="" src="../images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
  63 <li><img alt="" src="../images/down.gif" /> <a href="#identitycheck">IdentityCheck</a></li>
  64 <li><img alt="" src="../images/down.gif" /> <a href="#ifdefine">&lt;IfDefine&gt;</a></li>
  65 <li><img alt="" src="../images/down.gif" /> <a href="#ifmodule">&lt;IfModule&gt;</a></li>
  66 <li><img alt="" src="../images/down.gif" /> <a href="#include">Include</a></li>
  67 <li><img alt="" src="../images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
  68 <li><img alt="" src="../images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
  69 <li><img alt="" src="../images/down.gif" /> <a href="#limit">&lt;Limit&gt;</a></li>
  70 <li><img alt="" src="../images/down.gif" /> <a href="#limitexcept">&lt;LimitExcept&gt;</a></li>
  71 <li><img alt="" src="../images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
  72 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
  73 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
  74 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
  75 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
  76 <li><img alt="" src="../images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
  77 <li><img alt="" src="../images/down.gif" /> <a href="#location">&lt;Location&gt;</a></li>
  78 <li><img alt="" src="../images/down.gif" /> <a href="#locationmatch">&lt;LocationMatch&gt;</a></li>
  79 <li><img alt="" src="../images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
  80 <li><img alt="" src="../images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
  81 <li><img alt="" src="../images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
  82 <li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
  83 <li><img alt="" src="../images/down.gif" /> <a href="#require">Require</a></li>
  84 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
  85 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
  86 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
  87 <li><img alt="" src="../images/down.gif" /> <a href="#satisfy">Satisfy</a></li>
  88 <li><img alt="" src="../images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
  89 <li><img alt="" src="../images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
  90 <li><img alt="" src="../images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
  91 <li><img alt="" src="../images/down.gif" /> <a href="#servername">ServerName</a></li>
  92 <li><img alt="" src="../images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
  93 <li><img alt="" src="../images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
  94 <li><img alt="" src="../images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
  95 <li><img alt="" src="../images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
  96 <li><img alt="" src="../images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
  97 <li><img alt="" src="../images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
  98 <li><img alt="" src="../images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
  99 <li><img alt="" src="../images/down.gif" /> <a href="#timeout">TimeOut</a></li>
 100 <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
 101 <li><img alt="" src="../images/down.gif" /> <a href="#virtualhost">&lt;VirtualHost&gt;</a></li>
 102 </ul>
 103 </div>
 104
 105 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 106 <div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">Directiva</a></h2>
 107 <table class="directive">
 108 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Especifica si los recursos aceptan información de
 109 path añadida (trailing pathname information)</td></tr>
 110 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
 111 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
 112 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 113 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
 114 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 115 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 116 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>Disponible en la versiones de Apache 2.0.30 y posteriores</td></tr>
 117 </table>
 118
 119     <p>Esta directiva controla si las peticiones que contienen
 120     información de path añadida (trailing pathname
 121     information) a continuación de un nombre de fichero existente
 122     (o no existente en un directorio que sí existe) serán
 123     aceptadas o rechazadas. La información de path añadida
 124     (trailing pathname information) puede pasarse a los scripts en la
 125     variable de entorno <code>PATH_INFO</code>.</p>
 126
 127     <p>Por ejemplo, suponga que la ubicación <code>/test/</code>
 128     se refiere a un directorio que contiene un único fichero:
 129     <code>here.html</code>.  Entonces, tanto las peticiones a
 130     <code>/test/here.html/more</code> como las peticiones a
 131     <code>/test/nothere.html/more</code> toman <code>/more</code> como
 132     <code>PATH_INFO</code>.</p>
 133
 134     <p>Los tres argumentos que puede tomar la directiva
 135     <code class="directive">AcceptPathInfo</code> son:</p>
 136     <dl>
 137     <dt><code>Off</code></dt><dd>Una petición será aceptada
 138     solamente si se refiere literalmente a una ruta que existe.  Por
 139     tanto, una petición con información de path añadida
 140     (trailing pathname information) después de un nombre de
 141     fichero que existe, del tipo <code>/test/here.html/more</code>
 142     como en el ejemplo de arriba, devolverá el mensaje de error
 143     404 NOT FOUND.</dd>
 144
 145     <dt><code>On</code></dt><dd>Una petición será aceptada
 146     si la componente anterior a la información de path
 147     añadida (trailing pathname information) se refiere a un
 148     fichero que existe.  El ejemplo de arriba
 149     <code>/test/here.html/more</code> será aceptado si
 150     <code>/test/here.html</code> se refiere a un fichero
 151     válido.</dd>
 152
 153     <dt><code>Default</code></dt><dd>El tratamiento de las peticiones
 154     con información de path añadida (trailing pathname
 155     information) está determinado por el <a href="../handler.html">handler</a> responsable de la
 156     petición.  El handler básico para ficheros normales
 157     rechaza por defecto las peticiones de <code>PATH_INFO</code>. Los
 158     handlers que sirven scripts, como <a href="mod_cgi.html">cgi-script</a> e <a href="mod_isapi.html">isapi-handler</a>, generalmente aceptan
 159     <code>PATH_INFO</code> por defecto.</dd>
 160     </dl>
 161
 162     <p>El propósito principal de la directiva
 163     <code>AcceptPathInfo</code> es permitirle hacer prevalecer su
 164     propio criterio sobre el del handler acerca de si se debe aceptar
 165     o rechazar <code>PATH_INFO</code>. Esto es necesario por ejemplo,
 166     cuando use un <a href="../filter.html">filtro</a>, como <a href="mod_include.html">INCLUDES</a>, para generar contenido
 167     basado en <code>PATH_INFO</code>.  El handler básico
 168     rechazaría normalmente la petición. Puede usar la
 169     siguiente configuración para activar dicho script:</p>
 170
 171     <div class="example"><p><code>
 172       &lt;Files "mypaths.shtml"&gt;<br />
 173       <span class="indent">
 174         Options +Includes<br />
 175         SetOutputFilter INCLUDES<br />
 176         AcceptPathInfo On<br />
 177       </span>
 178       &lt;/Files&gt;
 179     </code></p></div>
 180
 181
 182 </div>
 183 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 184 <div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">Directiva</a></h2>
 185 <table class="directive">
 186 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Nombre del fichero de configuración distribuida</td></tr>
 187 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>AccessFileName <var>filename</var> [<var>filename</var>] ...</code></td></tr>
 188 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
 189 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
 190 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 191 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 192 </table>
 193     <p>Durante el procesamiento de una petición el servidor busca
 194     el primer fichero de configuración de esta lista de nombres
 195     en cada directorio de la ruta del documento, siempre y cuando los
 196     ficheros de configuración distribuida estén <a href="#allowoverride">activados para ese directorio</a>. Por
 197     ejemplo:</p>
 198
 199     <div class="example"><p><code>
 200       AccessFileName .acl
 201     </code></p></div>
 202
 203     <p>Antes de devolver el documento
 204     <code>/usr/local/web/index.html</code>, el servidor leerá
 205     <code>/.acl</code>, <code>/usr/.acl</code>,
 206     <code>/usr/local/.acl</code> y <code>/usr/local/web/.acl</code>
 207     buscando directivas, a menos que hayan sido desactivados con</p>
 208
 209     <div class="example"><p><code>
 210       &lt;Directory /&gt;<br />
 211       <span class="indent">
 212         AllowOverride None<br />
 213       </span>
 214       &lt;/Directory&gt;
 215     </code></p></div>
 216
 217 <h3>Consulte también</h3>
 218 <ul>
 219 <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
 220 <li><a href="../configuring.html">Ficheros de Configuración</a></li>
 221 <li><a href="../howto/htaccess.html">Ficheros .htaccess</a></li>
 222 </ul>
 223 </div>
 224 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 225 <div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">Directiva</a></h2>
 226 <table class="directive">
 227 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Parámetro del conjunto de caracteres que se
 228 añade cuando el tipo de contenido de una respuesta es
 229 <code>text/plain</code> o <code>text/html</code></td></tr>
 230 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>AddDefaultCharset On|Off|<var>charset</var></code></td></tr>
 231 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
 232 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 233 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
 234 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 235 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 236 </table>
 237     <p>Esta directiva especifica un valor por defecto para el
 238     parámetro del conjunto de caracteres que se añade
 239     añade si solo si el tipo de contenido de una respuesta es
 240     <code>text/plain</code> o <code>text/html</code>. EL valor
 241     pecificado en esta directiva no prevalecerá si cualquier otro
 242     conjunto de caracteres es especificado en el cuerpo del documento
 243     por medio de una etiqueta <code>META</code>, aunque a menudo, el
 244     comportamiento exacto está determinado por la
 245     configuración del cliente. Si se especifica
 246     <code>AddDefaultCharset Off</code>, se desactiva esta
 247     funcionalidad. <code>AddDefaultCharset On</code> activa el uso del
 248     conjunto de caracteres por defecto interno de Apache,
 249     <code>iso-8859-1</code>. Cualquier otro valor se asume que es el
 250     <var>charset</var> a usar, que será uno los <a href="http://www.iana.org/assignments/character-sets">registrados
 251     por la IANA</a> como tipos MIME. Por ejemplo:</p>
 252
 253     <div class="example"><p><code>
 254       AddDefaultCharset utf-8
 255     </code></p></div>
 256
 257     <p><code class="directive">AddDefaultCharset</code> debe ser usada solo
 258     cuando todos los recursos de texto a los que se aplican se saben
 259     que usan un determiando conjunto de caracteres (character
 260     encoding) y no es conveniente etiquetar los documentos
 261     individualmente. Un ejemplo es su uso en recursos que contienen
 262     contenido generado, como CGIs antiguos, que puede ser vulnerables
 263     a ataques debidos a que se incluye en el resultado datos
 264     suministrados por el usuario. Tenga en cuenta, sin embargo, que
 265     una mejor solución es simplemente modificar (o borrar) esos
 266     scripts, porque especificar un conjunto de caracteres por defecto
 267     no protege a los usuarios que tengan activada en su navegador la
 268     opción "auto-detect character encoding".</p>
 269
 270 <h3>Consulte también</h3>
 271 <ul>
 272 <li><code class="directive"><a href="../mod/mod_mime.html#addcharset">AddCharset</a></code></li>
 273 </ul>
 274 </div>
 275 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 276 <div class="directive-section"><h2><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a> <a name="addoutputfilterbytype" id="addoutputfilterbytype">Directiva</a></h2>
 277 <table class="directive">
 278 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Asigna un filtro de
 279 salida a un tipo MIME en particular</td></tr>
 280 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>AddOutputFilterByType <var>filter</var>[;<var>filter</var>...]
 281 <var>MIME-type</var> [<var>MIME-type</var>] ...</code></td></tr>
 282 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 283 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
 284 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 285 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 286 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>Disponible en las
 287 versiones de Apache 2.0.33 y posteriores</td></tr>
 288 </table>
 289     <p>Esta directiva activa un <a href="../filter.html">filtro</a> de
 290     salida en particular para las peticiones en función del tipo
 291     MIME de la respuesta.</p>
 292
 293     <p>El siguiente ejemplo usa el filtro <code>DEFLATE</code>, del
 294     módulo <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>. Este filtro comprime la
 295     parte de la respuesta de la petición (ya sea estática o
 296     dinámica) que esté etiquetada como
 297     <code>text/html</code> o <code>text/plain</code> antes de ser
 298     enviada al cliente.</p>
 299
 300     <div class="example"><p><code>
 301       AddOutputFilterByType DEFLATE text/html text/plain
 302     </code></p></div>
 303
 304     <p>Si quiere que los contenidos sean procesados por más de un
 305     filtro, debe separar sus nombres con puntos y comas
 306     (;). Tambén es posible usar la directiva
 307     <code class="directive">AddOutputFilterByType</code> para cada uno de los
 308     filtros.</p>
 309
 310     <p>La configuración que se muestra más abajo hace que
 311     todos los scripts etiquetados como <code>text/html</code> sean
 312     procesados primero por el filtro <code>INCLUDES</code> y
 313     posteriormente por el filtro <code>DEFLATE</code>.</p>
 314
 315     <div class="example"><p><code>
 316     &lt;Location /cgi-bin/&gt;<br />
 317     <span class="indent">
 318       Options Includes<br />
 319       AddOutputFilterByType INCLUDES;DEFLATE text/html<br />
 320     </span>
 321     &lt;/Location&gt;
 322     </code></p></div>
 323
 324     <div class="warning"><h3>Nota</h3> <p>Activar filtros con la
 325       directiva <code class="directive">AddOutputFilterByType</code> puede no
 326       funcionar parcial o totalmente. Por ejemplo, no se aplica
 327       ningún filtro si es posible determinar el tipo MIME y se
 328       aplica en su lugar <code class="directive"><a href="#defaulttype">DefaultType</a></code>, incluso si el <code class="directive"><a href="#defaulttype">DefaultType</a></code> es el mismo.</p>
 329
 330       <p>Si quiere estar seguro de que se apliquen los filtros, asigne
 331       el tipo de contenido a un recurso explícitamente, por ejemplo
 332       con la directiva <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> o con <code class="directive"><a href="#forcetype">ForceType</a></code>. Determinar el tipo de
 333       contenido dentro de un script CGI (que no sea del tipo nph)
 334       también es seguro.</p>
 335
 336       <p>Los filtros de salida por tipo no se aplican nunca en
 337       peticiones proxy.</p>
 338     </div>
 339
 340 <h3>Consulte también</h3>
 341 <ul>
 342 <li><code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li>
 343 <li><code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code></li>
 344 <li><a href="../filter.html">Filtros</a></li>
 345 </ul>
 346 </div>
 347 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 348 <div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a name="allowencodedslashes" id="allowencodedslashes">Directiva</a></h2>
 349 <table class="directive">
 350 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Determina si se acepta el uso de separadores de
 351 ubicación codificados en las URLs</td></tr>
 352 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>AllowEncodedSlashes On|Off</code></td></tr>
 353 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
 354 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
 355 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 356 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 357 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>Disponible en las versines de Apache 2.0.46 y posteriores</td></tr>
 358 </table>
 359     <p>La directiva <code class="directive">AllowEncodedSlashes</code>
 360     perimite usar URLs que contienen separadores de ubicación
 361     codificados (<code>%2F</code> para <code>/</code> y
 362     <code>%5C</code> para <code>\</code> en función del
 363     sistema). Normalmente, tales URLs se rechazan y se devuelve un
 364     mensaje de error 404 (Not found).</p>
 365
 366     <p>Especificar el valor <code>On</code> en la directiva
 367     <code class="directive">AllowEncodedSlashes</code> es útil sobre todo
 368     cuando se usa junto con <code>PATH_INFO</code>.</p>
 369
 370     <div class="note"><h3>Nota</h3> <p>Permitir barras codificadas
 371       <em>no</em> implica su <em>decodificado</em>.  La aparición
 372       de <code>%2F</code> o <code>%5C</code> (según el sistemas
 373       de que se trate) se dejará como tal en la cadena de
 374       caracteres que conforma la de otra manera URL decodificada.</p>
 375     </div>
 376
 377 <h3>Consulte también</h3>
 378 <ul>
 379 <li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
 380 </ul>
 381 </div>
 382 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 383 <div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">Directiva</a></h2>
 384 <table class="directive">
 385 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Tipos de directivas que cuyo uso está permitido en los ficheros <code>.htaccess</code></td></tr>
 386 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>AllowOverride All|None|<var>directive-type</var>
 387 [<var>directive-type</var>] ...</code></td></tr>
 388 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>AllowOverride All</code></td></tr>
 389 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>directory</td></tr>
 390 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 391 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 392 </table>
 393     <p>Cuando el servidor encuentra un fichero <code>.htaccess</code>
 394     (como se explica en la directiva <code class="directive"><a href="#accessfilename">AccessFileName</a></code>) es necesario saber que
 395     directivas presentes en ese fichero pueden prevalecer sobre
 396     las directivas de configuración previas.</p>
 397
 398     <div class="note"><h3>Solamente disponible en las secciones
 399     &lt;Directory&gt;</h3>
 400
 401     <code class="directive">AllowOverride</code> puede usarse solo en las
 402     secciones <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> especificadas sin expresiones
 403     regulares, nunca en las secciones <code class="directive"><a href="#location">&lt;Location&gt;</a></code>, <code class="directive"><a href="#directorymatch">&lt;DirectoryMatch&gt;</a></code> o <code class="directive"><a href="#files">&lt;Files&gt;</a></code>.
 404     </div>
 405
 406     <p>Cuando el valor de esta directiva es <code>None</code>,
 407     entonces los ficheros <a href="#accessfilename">.htaccess</a> son
 408     ignorados completamente. En ese caso, el servidor ni siquiera
 409     intentará leer los archivos <code>.htaccess</code>
 410     existentes.</p>
 411
 412     <p>Cuando el valor especificado en esta directiva es
 413     <code>All</code>, entonces cualquier directiva que tenga <a href="directive-dict.html#Context">Context</a> .htaccess puede ser
 414     usada en los ficheros <code>.htaccess</code>.</p>
 415
 416     <p>El <var>tipo de directiva</var> puede ser uno de los siguientes
 417     grupos de directivas.</p>
 418
 419     <dl>
 420       <dt>AuthConfig</dt>
 421
 422       <dd>
 423
 424       Permite usar directivas de autentificación (<code class="directive"><a href="../mod/mod_auth_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>, <code class="directive"><a href="../mod/mod_auth_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>, <code class="directive"><a href="../mod/mod_auth.html#authgroupfile">AuthGroupFile</a></code>, <code class="directive"><a href="#authname">AuthName</a></code>, <code class="directive"><a href="#authtype">AuthType</a></code>, <code class="directive"><a href="../mod/mod_auth.html#authuserfile">AuthUserFile</a></code>, <code class="directive"><a href="#require">Require</a></code>, <em>etc.</em>).</dd>
 425
 426       <dt>FileInfo</dt>
 427
 428       <dd>
 429       Permite usar directivas que controlan los tipos de documento
 430       (<code class="directive"><a href="#defaulttype">DefaultType</a></code>, <code class="directive"><a href="#errordocument">ErrorDocument</a></code>, <code class="directive"><a href="#forcetype">ForceType</a></code>, <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>,
 431       <code class="directive"><a href="#sethandler">SetHandler</a></code>, <code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>, <code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>, y
 432       <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> las directivas Add* y Remove*,
 433       <em>etc.</em>).</dd>
 434
 435       <dt>Indexes</dt>
 436
 437       <dd>
 438       Permite el uso de directivas que controlan el indexado de
 439       directorios (<code class="directive"><a href="../mod/mod_autoindex.html#adddescription">AddDescription</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#addicon">AddIcon</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#addiconbyencoding">AddIconByEncoding</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#defaulticon">DefaultIcon</a></code>, <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#fancyindexing">FancyIndexing</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#headername">HeaderName</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexignore">IndexIgnore</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexoptions">IndexOptions</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#readmename">ReadmeName</a></code>,
 440       <em>etc.</em>).</dd>
 441
 442       <dt>Limit</dt>
 443
 444       <dd>
 445       Permite el uso de directivas que controlan el acceso al host
 446       (<code class="directive"><a href="../mod/mod_access.html#allow">Allow</a></code>, <code class="directive"><a href="../mod/mod_access.html#deny">Deny</a></code> y <code class="directive"><a href="../mod/mod_access.html#order">Order</a></code>).</dd>
 447
 448       <dt>Options</dt>
 449
 450       <dd>
 451       Permite usar directivas que controlan funcionalidades
 452       específicas de directorios (<code class="directive"><a href="#options">Options</a></code> y <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>).</dd>
 453     </dl>
 454
 455     <p>Ejemplo:</p>
 456
 457     <div class="example"><p><code>
 458       AllowOverride AuthConfig Indexes
 459     </code></p></div>
 460
 461     <p>En el ejemplo de arriba todas las directivas que no están
 462     en el grupo <code>AuthConfig</code> ni en el grupo
 463     <code>Indexes</code> provocan un error interno del servidor.</p>
 464
 465 <h3>Consulte también</h3>
 466 <ul>
 467 <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
 468 <li><a href="../configuring.html">Ficheros de
 469 Configuración</a></li>
 470 <li><a href="../howto/htaccess.html">Ficheros .htaccess</a></li>
 471 </ul>
 472 </div>
 473 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 474 <div class="directive-section"><h2><a name="AuthName" id="AuthName">AuthName</a> <a name="authname" id="authname">Directiva</a></h2>
 475 <table class="directive">
 476 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Ambito de autorización para su uso en
 477 autentificación HTTP</td></tr>
 478 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>AuthName <var>auth-domain</var></code></td></tr>
 479 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>directory, .htaccess</td></tr>
 480 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>AuthConfig</td></tr>
 481 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 482 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 483 </table>
 484     <p>Esta directiva especifica el nombre de dominio que se muestra
 485      al solicitar autorización para acceder a un directorio. Este
 486      nombre de dominio se muestra al cliente para que el usuario sepa
 487      qué nombre de usuario y contraseña ha de introducir.
 488      <code class="directive">AuthName</code> toma solamente un argumento; si
 489      el nombre de dominio contiene algún espacio, debe escribirse
 490      entre comillas. Para que funcione correctamente, esta directiva
 491      debe usarse junto con las directivas <code class="directive"><a href="#authtype">AuthType</a></code> y <code class="directive"><a href="#require">Require</a></code>, y con directivas como
 492      <code class="directive"><a href="../mod/mod_auth.html#authuserfile">AuthUserFile</a></code> y
 493      <code class="directive"><a href="../mod/mod_auth.html#authgroupfile">AuthGroupFile</a></code>.</p>
 494
 495    <p>Por ejemplo:</p>
 496
 497    <div class="example"><p><code>
 498      AuthName "Top Secret"
 499    </code></p></div>
 500
 501     <p>La cadena de caracteres que se especifique como valor de
 502     <code>AuthName</code> será lo que aparecerá en el cuadro
 503     de diálogo de acceso de la mayoría de los
 504     navegadores.</p>
 505
 506 <h3>Consulte también</h3>
 507 <ul>
 508 <li>
 509     <a href="../howto/auth.html">Autentificación, Autorización y
 510     Control de Acceso</a></li>
 511 </ul>
 512 </div>
 513 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 514 <div class="directive-section"><h2><a name="AuthType" id="AuthType">AuthType</a> <a name="authtype" id="authtype">Directiva</a></h2>
 515 <table class="directive">
 516 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Tipo de autentificación de usuarios</td></tr>
 517 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>AuthType Basic|Digest</code></td></tr>
 518 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>directory, .htaccess</td></tr>
 519 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>AuthConfig</td></tr>
 520 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 521 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 522 </table>
 523     <p>Esta directiva selecciona el tipo de autentificación de
 524     usuarios que usará para un directorio. Actualmente solamente
 525     están implementadas las opciones <code>Basic</code> y
 526     <code>Digest</code>.
 527
 528      Para que funcione correctamente, esta directiva tiene que ir
 529      acompañada por las directivas <code class="directive"><a href="#authname">AuthName</a></code> y <code class="directive"><a href="#require">Require</a></code>, y de directivas como
 530      <code class="directive"><a href="../mod/mod_auth.html#authuserfile">AuthUserFile</a></code> y
 531      <code class="directive"><a href="../mod/mod_auth.html#authgroupfile">AuthGroupFile</a></code>.</p>
 532
 533 <h3>Consulte también</h3>
 534 <ul>
 535 <li><a href="../howto/auth.html">&gt;Autentificación, Autorización y
 536 Control de Acceso</a></li>
 537 </ul>
 538 </div>
 539 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 540 <div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">Directiva</a></h2>
 541 <table class="directive">
 542 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Técnica para localizar
 543 un intérprete de scripts CGI</td></tr>
 544 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>CGIMapExtension <var>cgi-path</var>
 545 <var>.extension</var></code></td></tr>
 546 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>directory, .htaccess</td></tr>
 547 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
 548 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 549 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 550 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>Solamente NetWare</td></tr>
 551 </table>
 552     <p>Esta directiva se usa para controlar la forma en que Apache
 553     encuentra el intérprete para ejecutar scripts CGI. Por
 554     ejemplo, si usa <code>CGIMapExtension sys:\foo.nlm .foo</code>,
 555     todos los scripts CGI con extensión <code>.foo</code> se
 556     pasarán al intérprete FOO.</p>
 557
 558 </div>
 559 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 560 <div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a> <a name="contentdigest" id="contentdigest">Directiva</a></h2>
 561 <table class="directive">
 562 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Activa la generación de cabeceras de respuesta HTTP
 563 <code>Content-MD5</code></td></tr>
 564 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>ContentDigest On|Off</code></td></tr>
 565 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>ContentDigest Off</code></td></tr>
 566 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 567 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>Options</td></tr>
 568 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 569 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 570 </table>
 571     <p>Esta directiva permite la generación de cabeceras
 572     <code>Content-MD5</code> según se definen en RFC1864 y
 573     RFC2068.</p>
 574
 575     <p>MD5 es un algoritmo que genera una cadena de caracteres
 576     ("message digest", a veces llamado "huella dactilar") a partir de
 577     unos datos de longitud arbitraria. La forma en que funciona este
 578     algoritmo hace que con casi toda seguridad, si se producen
 579     alteraciones en los datos originales, el "message digest" generado
 580     también será diferente.</p>
 581
 582     <p>La cabecera <code>Content-MD5</code> es una forma de comprobar
 583     la integridad de un mensaje de principio a fin (MIC) para los
 584     mensajes HTTP (entity-body). Un proxy o un cliente pueden
 585     comprobar esta cabecera para detectar modificaciones accidentales
 586     en el mensaje HTTP (entity-body) en tránsito. Cabecera de
 587     ejemplo:</p>
 588
 589     <div class="example"><p><code>
 590       Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
 591     </code></p></div>
 592
 593     <p>Tenga en cuenta que el uso de esta directiva puede provocar un
 594     menor rendimiento de su servidor porque el "message digest" se
 595     genera en cada petición (los valores no se guardan).</p>
 596
 597     <p>La cebecera <code>Content-MD5</code> se envía solamente
 598     cuando un documento es servido por <code class="module"><a href="../mod/core.html">core</a></code>. Si el
 599     documento es servido con cuaquier otro módulo, no se
 600     envía. Por ejemplo, los documentos SSI, las salidas de
 601     scripts CGI, y las respuesta parciales (byte range responses) no
 602     tienen esta cabecera.</p>
 603
 604 </div>
 605 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 606 <div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">Directiva</a></h2>
 607 <table class="directive">
 608 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Tipo de contenido MIME por defecto que usará el servidor si no
 609 puede determinar el tipo MIME en concreto del documento a servir</td></tr>
 610 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>DefaultType <var>MIME-type</var></code></td></tr>
 611 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>DefaultType text/plain</code></td></tr>
 612 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 613 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
 614 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 615 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 616 </table>
 617     <p>Hay veces en las que se pide al servidor que devuelva un
 618     documento cuyo tipo MIME no puede determinar.</p>
 619
 620     <p>El servidor tiene que informar al cliente del tipo de contenido
 621     del documento. En el caso de que se trate de un tipo desconocido,
 622     se usa el tipo <code>DefaultType</code>. Por ejemplo:</p>
 623
 624     <div class="example"><p><code>
 625       DefaultType image/gif
 626     </code></p></div>
 627
 628     <p>sería apropiado para un directorio que contenga muchas
 629     imagenes tipo GIF cuyos nombres de fichero no tengan la
 630     extensión <code>.gif</code>.</p>
 631
 632     <p>Tenga en cuenta que a diferencia de <code class="directive"><a href="#forcetype">ForceType</a></code>, esta directiva solamente
 633     indica el tipo MIME por defecto. El resto de definiciones de tipos
 634     MIME, incluidas las extensiones de fichero, que pueden identificar
 635     el tipo MIME de que se trata prevalecen sobre esta opción por
 636     defecto.</p>
 637
 638 </div>
 639 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 640 <div class="directive-section"><h2><a name="Directory" id="Directory">&lt;Directory&gt;</a> <a name="directory" id="directory">Directiva</a></h2>
 641 <table class="directive">
 642 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Engloba a un grupo de directivas
 643 que se aplicarán solamente al directorio del sistema de ficheros
 644 especificado y a sus subdirectorios</td></tr>
 645 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>&lt;Directory <var>directory-path</var>&gt;
 646 ... &lt;/Directory&gt;</code></td></tr>
 647 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
 648 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 649 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 650 </table>
 651     <p>Las directivas <code class="directive">&lt;Directory&gt;</code>
 652     y <code>&lt;/Directory&gt;</code> se usan para englobar un grupo
 653     de directivas que se aplicarán solamente al directorio
 654     especificado y a sus subdirectorios. Puede incluir a cualquier
 655     directiva cuyo uso esté permitido en un contexto
 656     &lt;directory&gt;. <var>Directory-path</var> puede ser tanto la
 657     ruta completa a un directorio, como una cadena de caracteres
 658     comodín que use las reglas de equivalencia de los shells de
 659     Unix. En una cadena de caracteres comodín, el carácter
 660     <code>?</code> equivale a cualquier carácter individual, y
 661     <code>*</code> equivale a cualquier secuencia de
 662     caracteres. También puede usar <code>[]</code> para expresar
 663     rangos de caracteres. Ninguno de los caracteres comodín
 664     equivale al carácter `/', de modo que <code>&lt;Directory
 665     /*/public_html&gt;</code> no equivale a
 666     <code>/home/user/public_html</code>, pero sí a
 667     <code>&lt;Directory /home/*/public_html&gt;</code>. Ejemplo:</p>
 668
 669     <div class="example"><p><code>
 670       &lt;Directory /usr/local/httpd/htdocs&gt;<br />
 671       <span class="indent">
 672         Options Indexes FollowSymLinks<br />
 673       </span>
 674       &lt;/Directory&gt;
 675     </code></p></div>
 676
 677     <div class="note">
 678       <p>Tenga especial cuidado con los argumentos de
 679       <var>directory-path</var>: tienen que equivaler literalmente a
 680       la ruta del sistema de ficheros que Apache usa para acceder a
 681       los ficheros. Las directivas aplicadas a un
 682       <code>&lt;Directory&gt;</code> en particular no se
 683       aplicarán a los ficheros de ese mismo directorio pero que
 684       sean accedidos mediante una ruta diferente, como por ejemplo
 685       mediante enlaces simbólicos diferentes.</p>
 686     </div>
 687
 688     <p>También pueden usar expresiones regulares extendidas,
 689     añadiendo el carácter <code>~</code>. Por ejemplo:</p>
 690
 691     <div class="example"><p><code>
 692       &lt;Directory ~ "^/www/.*/[0-9]{3}"&gt;
 693     </code></p></div>
 694
 695     <p>equivaldría a los directorios en <code>/www/</code> cuyo
 696     nombres consistan en tres números.</p>
 697
 698     <p>Si varias (expresiones no regulares) secciones <code class="directive">&lt;Directory&gt;</code> equivalen al directorio (o a
 699     uno de los directorios de los que es subdirectorio) que contiene
 700     un documento, entonces las directivas se aplican según el
 701     criterio de la ruta equivalente más corta, junto con las
 702     directivas de los archivos <a href="#accessfilename">.htaccess</a>. Por ejemplo, con</p>
 703
 704     <div class="example"><p><code>
 705       &lt;Directory /&gt;<br />
 706       <span class="indent">
 707         AllowOverride None<br />
 708       </span>
 709       &lt;/Directory&gt;<br />
 710       <br />
 711       &lt;Directory /home/&gt;<br />
 712       <span class="indent">
 713         AllowOverride FileInfo<br />
 714       </span>
 715       &lt;/Directory&gt;
 716     </code></p></div>
 717
 718     <p>para acceder al documento <code>/home/web/dir/doc.html</code>
 719     los pasos son:</p>
 720
 721     <ul>
 722       <li>Se aplica la directiva <code>AllowOverride None</code>
 723       (desactivando los ficheros <code>.htaccess</code>).</li>
 724
 725       <li>Se aplica la directiva <code>AllowOverride FileInfo</code>
 726       (para el directorio <code>/home</code>).</li>
 727
 728       <li>Se aplica cualquier directiva <code>FileInfo</code> en
 729       <code>/home/.htaccess</code>, <code>/home/web/.htaccess</code> y
 730       <code>/home/web/dir/.htaccess</code> por ese orden.</li>
 731     </ul>
 732
 733     <p>Las expresiones regulares no se tienen en cuenta hasta que
 734     todas las secciones normales hayan sido aplicadas. En ese momento
 735     todas se evalúan las expresiones regulares en el orden en que
 736     aparecen en el fichero de configuración. Por ejemplo, con</p>
 737
 738     <div class="example"><p><code>
 739       &lt;Directory ~ abc$&gt;<br />
 740       <span class="indent">
 741         # ... directivas aquí ...<br />
 742       </span>
 743       &lt;/Directory&gt;
 744     </code></p></div>
 745
 746     <p>la sección de expresiones regulares no será
 747     considerada hasta después de que todas las directivas
 748     <code class="directive">&lt;Directory&gt;</code> y los ficheros
 749     <code>.htaccess</code> hayan sido aplicados. Solamente entonces
 750     las expresiones regulares que tengan una equivalencia con
 751     <code>/home/abc/public_html/abc</code> y la correspondiente
 752     directiva <code class="directive">&lt;Directory&gt;</code>
 753     serán aplicadas.</p>
 754
 755    <p><strong>Tenga en cuenta que por defecto el acceso de Apache a
 756     <code>&lt;Directory /&gt;</code> es <code>Allow from All</code>.
 757     Esto significa que Apache servirá cualquier fichero que se
 758     corresponda con una URL. Se recomienda que modifique este
 759     comportamiento con un bloque del siguiente tipo</strong></p>
 760
 761     <div class="example"><p><code>
 762       &lt;Directory /&gt;<br />
 763       <span class="indent">
 764         Order Deny,Allow<br />
 765         Deny from All<br />
 766       </span>
 767       &lt;/Directory&gt;
 768     </code></p></div>
 769
 770     <p><strong>y haga prevalecer una configuración diferente para
 771     los solamente para los directorios que usted <em>quiera</em> que
 772     sean accesibles. Consulte la sección <a href="../misc/security_tips.html">Consejos de seguridad</a> para
 773     obtener más información.</strong></p>
 774
 775     <p>Las secciones "directory" se usan en el archivo
 776     <code>httpd.conf</code>.  Las directivas <code class="directive">&lt;Directory&gt;</code> no pueden anidarse, y no
 777     pueden aparecer en una sección de tipo <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> o <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>.</p>
 778
 779 <h3>Consulte también</h3>
 780 <ul>
 781 <li><a href="../sections.html">Documentación de
 782     cómo funcionan las secciones &lt;Directory&gt;,
 783     &lt;Location&gt; y &lt;Files&gt;</a> para obtener más
 784     información sobre la forma en que se combinan estas secciones
 785     cuando se recibe una petición</li>
 786 </ul>
 787 </div>
 788 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 789 <div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch">&lt;DirectoryMatch&gt;</a> <a name="directorymatch" id="directorymatch">Directiva</a></h2>
 790 <table class="directive">
 791 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Incluye las directivas que se
 792 aplican a los directorios y subdirectorios del sistema de ficheros que
 793 equivalen a una expresión regular</td></tr>
 794 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>&lt;DirectoryMatch <var>regex</var>&gt;
 795 ... &lt;/DirectoryMatch&gt;</code></td></tr>
 796 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
 797 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 798 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 799 </table>
 800     <p><code class="directive">&lt;DirectoryMatch&gt;</code> y
 801     <code>&lt;/DirectoryMatch&gt;</code> se usan para englobar a un
 802     grupo de directivas que se aplicarán solamente al directorio
 803     (y los subdirectorios de éste) especificado, al igual que
 804     <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>. Sin
 805     embargo, en ese caso la directiva toma como argumento una
 806     expresión regular. Por ejemplo:</p>
 807
 808     <div class="example"><p><code>
 809       &lt;DirectoryMatch "^/www/.(.+)?[0-9]{3}"&gt;
 810     </code></p></div>
 811
 812     <p>equivaldrá a los directorios en <code>/www/</code> cuyo nombre
 813     consista en tres números.</p>
 814
 815 <h3>Consulte también</h3>
 816 <ul>
 817 <li><code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>
 818 si quiere una descripción completa de cómo se usan
 819 conjuntamente las expresiones regulares con la directiva <code class="directive">&lt;Directory&gt;</code></li>
 820 <li><a href="../sections.html">Modo de funcionamiento de las secciones
 821 &lt;Directory&gt;, &lt;Location&gt; y &lt;Files&gt;</a> para obtener
 822 más información sobre como se combinan estas secciones
 823 cuando se recibe una petición</li>
 824 </ul>
 825 </div>
 826 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 827 <div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">Directiva</a></h2>
 828 <table class="directive">
 829 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Directorio principal que contiene la estructura de
 830 directorios visible desde la web</td></tr>
 831 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>DocumentRoot <var>directory-path</var></code></td></tr>
 832 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
 833 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
 834 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 835 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 836 </table>
 837     <p>Esta directiva especifica el directorio desde el cuál
 838     <code class="program"><a href="../programs/httpd.html">httpd</a></code> servirá los ficheros. A menos que
 839     especifique alguna otra equivalencia mediante una directiva
 840     <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, el servidor
 841     añade la ruta de la URL solicitada a este directorio para
 842     construir la ruta del documento a servir. Ejemplo:</p>
 843
 844     <div class="example"><p><code>
 845       DocumentRoot /usr/web
 846     </code></p></div>
 847
 848     <p>esto quiere decir que una petición de acceso a
 849     <code>http://www.my.host.com/index.html</code> se refiere a
 850     <code>/usr/web/index.html</code> en el sistema de ficheros.</p>
 851
 852     <p>El directorio que especifique en
 853     <code class="directive">DocumentRoot</code> debe escribirlo sin barra al
 854     final.</p>
 855
 856 <h3>Consulte también</h3>
 857 <ul>
 858 <li><a href="../urlmapping.html">Cómo traducir URLs a
 859 ubicaciones del sistema de ficheros</a></li>
 860 </ul>
 861 </div>
 862 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 863 <div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">Directiva</a></h2>
 864 <table class="directive">
 865 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Permite el uso de mapeo de memoria para leer archivos mientras se
 866 sirven</td></tr>
 867 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
 868 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>EnableMMAP On</code></td></tr>
 869 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 870 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
 871 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 872 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 873 </table>
 874     <p>Esta directiva controla si <code class="program"><a href="../programs/httpd.html">httpd</a></code> puede usar
 875     mapeo de memoria en caso de ser necesario para leer los contenidos
 876     de un archivo al servirlo.  Por defecto, cuando el tratamiento de
 877     una petición requiere acceder a los datos dentro de un
 878     fichero -- por ejemplo, cuando se sirve un fichero analizado
 879     sintácticamente por el servidor con el módulo
 880     <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> -- Apache mapea en memoria el archivo
 881     si el sistema operativo soporta esa operación.</p>
 882
 883     <p>El mapeo de memoria supone a veces una mejora en el
 884     rendimiento. Sin embargo, en ciertos entornos, es mejor desactivar
 885     el mapeo de memoria para evitar problemas operacionales:</p>
 886
 887     <ul>
 888     <li>En algunos sistemas con más de un procesador, el mapeo de
 889     memoria puede reducir el rendimiento de
 890     <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</li> <li>Con un <code class="directive"><a href="#documentroot">DocumentRoot</a></code> montado en NFS,
 891     <code class="program"><a href="../programs/httpd.html">httpd</a></code> podría abortar su ejecución
 892     debido a un fallo de segmentación si el fichero se borra o se
 893     trunca mientras que <code class="program"><a href="../programs/httpd.html">httpd</a></code> lo tiene mapeado en
 894     memoria.</li>
 895     </ul>
 896
 897     <p>Para configuraciones del servidor que son sensibles a estos
 898     problemas, debe desactivar el uso del mapeo en memoria
 899     especificando:</p>
 900
 901     <div class="example"><p><code>
 902       EnableMMAP Off
 903     </code></p></div>
 904
 905     <p>Para ficheros montados en NFS, puede desactivar esta
 906     funcionalidad explícitamente para los archivos implicados
 907     especificando:</p>
 908
 909     <div class="example"><p><code>
 910       &lt;Directory "/path-to-nfs-files"&gt;
 911       <span class="indent">
 912         EnableMMAP Off
 913       </span>
 914       &lt;/Directory&gt;
 915     </code></p></div>
 916
 917 </div>
 918 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 919 <div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a name="enablesendfile" id="enablesendfile">Directiva</a></h2>
 920 <table class="directive">
 921 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Permite el uso del soporte de sendfile del kernel para servir ficheros @@@@@ Use the kernel sendfile support to deliver files to the client @@@@@ </td></tr>
 922 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
 923 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>EnableSendfile On</code></td></tr>
 924 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 925 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
 926 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 927 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 928 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>Disponible en las versiones de Apache 2.0.44 y
 929 posteriores</td></tr>
 930 </table>
 931     <p>Esta directiva controla si <code class="program"><a href="../programs/httpd.html">httpd</a></code> puede usar
 932     el soporte de sendfile del kernel para transmitir contenidos de
 933     ficheros al cliente.  Por defecto, cuando se está procesando
 934     una petición que no requiere acceso a los datos de un fichero
 935     -- por ejemplo, cuando se sirve un fichero estático -- Apache
 936     usa sendfile para servir los contenidos del fichero directamente a
 937     la red, sin leer el fichero si el sistema operativo lo
 938     permite.</p>
 939
 940     <p>El mecanismo sendfile evita operaciones separadas de lectura y
 941     envío, y reservas de buffer. Sin embargo, en algunas
 942     plataformas o en algunos sistemas de ficheros, es mejor desactivar
 943     esa funcionalidad para evitar problemas operacionales:</p>
 944
 945     <ul>
 946     <li>En algunas plataformas puede que el soporte de sendfile no
 947     funcione porque al compilar Apache no se detectó
 948     correctamente, especialmente si los binarios fueron construidos en
 949     una máquina y después se han trasladado a otra cuando el
 950     soporte para sendfile ya no funcionaba.</li>
 951
 952     <li>En Linux, el uso de send file provoca fallos de
 953     comprobación de TCP_checksum en ciertas tarjetas de red que
 954     usan IPv6</li>
 955
 956     <li>Si <code class="directive"><a href="#documentroot">DocumentRoot</a></code> está
 957     montado en red (por ejemplo, NFS o SMB), el kernel puede que no
 958     sea capaz de servir el fichero de red a través de su
 959     cache.</li>
 960     </ul>
 961
 962     <p>Para configuraciones del servidor que son sensibles a estos
 963     problemas, debe desactivar esta funcionalidad especificando:</p>
 964
 965     <div class="example"><p><code>
 966       EnableSendfile Off
 967     </code></p></div>
 968
 969     <p>Para archivos montados en NFS o SMB, esta funcionalidad puede
 970     ser desactivada explícitamente para los ficheros que puedan
 971     ocasionar problemas mediante:</p>
 972
 973     <div class="example"><p><code>
 974       &lt;Directory "/path-to-nfs-files"&gt;
 975       <span class="indent">
 976         EnableSendfile Off
 977       </span>
 978       &lt;/Directory&gt;
 979     </code></p></div>
 980
 981 </div>
 982 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 983 <div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">Directiva</a></h2>
 984 <table class="directive">
 985 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Es lo que el servidor devuelve al cliente si se produce
 986 algún error</td></tr>
 987 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>ErrorDocument <var>error-code</var>
 988 <var>document</var></code></td></tr>
 989 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 990 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
 991 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
 992 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
 993 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>El uso de las comillas
 994 (") en los mensajes de texto es diferente en Apache
 995 2.0</td></tr>
 996 </table>
 997     <p>En el caso de que aparezca un problema o error, puede
 998     configurar Apache para hacer una de las siguientes cuatro
 999     cosas,</p>
1000
1001     <ol>
1002       <li>devolver un mensaje de error estándar</li>
1003
1004       <li>devolver un mensaje de error personalizado</li>
1005
1006       <li>redireccionar la petición a una <var>ruta-URL</var>
1007       local</li>
1008
1009       <li>redireccionar la petición a una <var>URL</var> externa</li>
1010     </ol>
1011
1012     <p>La primera opción es la que se usa por defecto, mientras
1013     que el resto se pueden configurar usando la directiva
1014     <code class="directive">ErrorDocument</code>, la cual ha de seguirse del
1015     código de respuesta HTTP y una URL o un mensaje. Apache
1016     ofrece a veces otra información adicional sobre el problema o
1017     error.</p>
1018
1019     <p>Las URLs pueden empezar por una barra (/) para URLs locales, o
1020     pueden ser una URL completa que el cliente pueda
1021     resolver. También se puede hacer que el nevagador despliegue
1022     un mensaje. Ejemplos:</p>
1023
1024     <div class="example"><p><code>
1025       ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
1026       ErrorDocument 404 /cgi-bin/bad_urls.pl<br />
1027       ErrorDocument 401 /subscription_info.html<br />
1028       ErrorDocument 403 "Lo sentimos no  podemos permitirle el acceso a esta página hoy"
1029     </code></p></div>
1030
1031     <p>Adicionalmente, el valor especial <code>default</code> puede
1032     ser usado para que Apache use los mensajes literales que trae por
1033     defecto. Aunque bajo circunstancias normales no es necesario,
1034     <code>default</code> restaura los mensajes literales de Apache en
1035     configuraciones que de otra manera heredan una directiva
1036     <code class="directive">ErrorDocument</code> ya existente.</p>
1037
1038     <div class="example"><p><code>
1039       ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br />
1040       &lt;Directory /web/docs&gt;<br />
1041       <span class="indent">
1042         ErrorDocument 404 default<br />
1043       </span>
1044       &lt;/Directory&gt;
1045     </code></p></div>
1046
1047     <p>Tenga en cuenta que si usted especifica en
1048     <code class="directive">ErrorDocument</code> un contenido que apunta a una
1049     URL remota (por ejemplo, cualquier cosa que empiece por
1050     <code>http</code>), Apache redireccionará al cliente, incluso
1051     si al final, el documento al que redirecciona está en el
1052     mismo servidor. Esto tiene varias implicaciones, la más
1053     importante es que el cliente no recibirá el código de
1054     error original, sino que en su lugar recibirá el código
1055     de estado del redireccionamiento. Esto puede confundir a los
1056     robots web y otros clientes que tratan de determinar si una URL es
1057     válida usando el código de estado. Además, si usa
1058     una URL remota en un <code>ErrorDocument 401</code>, el cliente no
1059     sabrá pedir contraseñas al usuario porque no
1060     recibirá el código de estado 401. Por tanto, <strong>si
1061     usa una directiva <code>ErrorDocument 401</code> entonces
1062     debe referirse a un documento local.</strong></p>
1063
1064     <p>Microsoft Internet Explorer (MSIE) ignorará por defecto
1065     los mensajes de error generados por el servidor cuando sean
1066     "demasiado pequeños" y los sustituirá por mensajes de
1067     error propios. El tamaño se considera pequeño según
1068     el tipo de error de que se trate, pero en general, si su mensaje
1069     de error es de más de 512 bytes, MSIE mostrará en
1070     mensaje del error generado por el servidor y no el suyo. Puede
1071     encontrar más información sobre este asunto en el
1072     artículo de la Base de Datos de Conocimiento de Microsoft <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p>
1073
1074     <p>En las versiones de Apache anteriores a la 2.0, los mensajes se
1075     indicaban añadiendoles dobles comillas (") al principio que
1076     no se cerraban al final del mensaje.</p>
1077
1078 <h3>Consulte también</h3>
1079 <ul>
1080 <li><a href="../custom-error.html">Documentación sobre
1081 personalización de respuestas</a></li>
1082 </ul>
1083 </div>
1084 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1085 <div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a name="errorlog" id="errorlog">Directiva</a></h2>
1086 <table class="directive">
1087 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Ubicación del fichero en
1088 el que se almacenan los mensajes de error</td></tr>
1089 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code> ErrorLog <var>file-path</var>|syslog[:<var>facility</var>]</code></td></tr>
1090 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows y OS/2)</code></td></tr>
1091 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
1092 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1093 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1094 </table>
1095     <p>La directiva <code class="directive">ErrorLog</code> determina el
1096     nombre del fichero en el cual el servidor almacenará los
1097     mensajes de error en caso de que ocurra alguno. Si el
1098     <var>file-path</var> no es absoluto, entonces se asume que es
1099     relativo al valor especificado en la directiva <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
1100
1101     <div class="example"><h3>Ejemplo</h3><p><code>
1102     ErrorLog /var/log/httpd/error_log
1103     </code></p></div>
1104
1105     <p>Si el <var>file-path</var> empieza con un barra vertical (|)
1106     entonces se asume que es un comando para procesar el registro de
1107     errores (error_log).</p>
1108
1109     <div class="example"><h3>Ejemplo</h3><p><code>
1110     ErrorLog "|/usr/local/bin/httpd_errors"
1111     </code></p></div>
1112
1113     <p>Usar <code>syslog</code> en lugar de un nombre de fichero
1114     permite almanecer los mesajes mediante syslogd(8) si el sistema lo
1115     soporta. Por defecto se usa la utilidad de syslog
1116     <code>local7</code>, pero puede cambiar esto usando
1117     <code>syslog:<var>facility</var></code> donde <var>facility</var>
1118     es cualquiera de los nombres normalmente documentados en
1119     syslog(1).</p>
1120
1121     <div class="example"><h3>Ejemplo</h3><p><code>
1122     ErrorLog syslog:user
1123     </code></p></div>
1124
1125     <p>SEGURIDAD: Consulte la sección <a href="../misc/security_tips.html#serverroot">consejos sobre
1126     seguridad</a> para obtener más información sobre cómo se
1127     compromete la seguridad de su sistema si sobre el directorio en
1128     que se almacenan los ficheros log tiene permisos cualquier usuario
1129     que no sea únicamente el que arranca el servidor.</p> <div class="warning">
1130
1131     <h3>Nota</h3> <p>Cuando se especifica una ruta a un fichero
1132     en una plataforma que no es Unix, hay que tener cuidado de usar
1133     solo barras (/) aunque el sistema permita barras invertidas
1134     (\). En general, lo mejor es usar siempre barras / en los ficheros
1135     de configuración.</p>
1136     </div>
1137
1138 <h3>Consulte también</h3>
1139 <ul>
1140 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
1141 <li><a href="../logs.html">Archivos Log de Apache</a></li>
1142 </ul>
1143 </div>
1144 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1145 <div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a> <a name="fileetag" id="fileetag">Directiva</a></h2>
1146 <table class="directive">
1147 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Atributos de fichero usados para crear la ETAG de la
1148 cabecera de respuesta HTTP</td></tr>
1149 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>FileETag <var>component</var> ...</code></td></tr>
1150 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>FileETag INode MTime Size</code></td></tr>
1151 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
1152 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
1153 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1154 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1155 </table>
1156     <p>
1157     La directiva <code class="directive">FileETag</code> configura los
1158     atributos de fichero que se usan para crear la <code>ETag</code>
1159     (etiqueta de entidad) del campo cabecera de respuesta cuando el
1160     documento está basado en un fichero. (El valor de
1161     <code>ETag</code> se usa en la gestión de cache para ahorrar
1162     ancho de banda.) En Apache 1.3.22 y en versiones anteriores, el
1163     valor de <code>ETag</code> se formaba <em>siempre</em> a partir
1164     del inodo del fichero, su tamaño y la hora y la fecha en que
1165     se modificó por última vez (mtime). La directiva
1166     <code class="directive">FileETag</code> permite elegir cuál de esos
1167     elementos quiere usar -- si es que se quiere usar alguno. Las
1168     palabras clave reconocidas son:
1169     </p>
1170
1171     <dl>
1172      <dt><strong>INode</strong></dt>
1173      <dd>Para incluir el número de inodo en el cálculo</dd>
1174      <dt><strong>MTime</strong></dt>
1175      <dd>Para incluir en el cálculo la hora y la fecha en que el
1176      fichero fue modificado por última vez</dd>
1177      <dt><strong>Size</strong></dt>
1178      <dd>Para incluir en el cálculo el número de bytes que ocupa el fichero</dd>
1179      <dt><strong>All</strong></dt>
1180      <dd>Para incluir en el cálculo todos los campos disponibles. Esto es
1181      equivalente a:
1182          <div class="example"><p><code>FileETag INode MTime Size</code></p></div></dd>
1183      <dt><strong>None</strong></dt>
1184      <dd>Si el documento está basado en un fichero, ningún campo
1185      <code>ETag</code> será incluido en la respuesta</dd>
1186     </dl>
1187
1188     <p>Las palabras clave <code>INode</code>, <code>MTime</code>, y
1189     <code>Size</code> pueden ir precedidas por <code>+</code> o
1190     <code>-</code>, lo cual permite hacer cambios en la configuración
1191     heredada de un ámbito más amplio. Cualquier palabra clave que
1192     aparezca sin un prefijo cancela inmediatamente la configuración
1193     heredada.</p>
1194
1195     <p>Si la configuración para un directorio incluye
1196     <code>FileETag INode MTime Size</code>, y la de un subdirectorio
1197     incluye <code>FileETag -INode</code>, la configuración para
1198     ese subdirectorio (que será heredada por cualquier
1199     subdirectorio que no tenga un configuración propia) será
1200     equivalente a <code>FileETag MTime Size</code>.</p>
1201
1202 </div>
1203 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1204 <div class="directive-section"><h2><a name="Files" id="Files">&lt;Files&gt;</a> <a name="files" id="files">Directiva</a></h2>
1205 <table class="directive">
1206 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Contiene directivas que se aplican a los ficheros cuyos
1207 nombres coincidan con los que se especifiquen</td></tr>
1208 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>&lt;Files <var>filename</var>&gt; ... &lt;/Files&gt;</code></td></tr>
1209 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
1210 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>All</td></tr>
1211 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1212 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1213 </table>
1214     <p>La directiva <code class="directive">&lt;Files&gt;</code> limita el ámbito de aplicación de las directivas que incluye según el nombre de los ficheros. Es
1215     comparable a <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> y <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Debe cerrarse con <code>&lt;/Files&gt;</code>. Las directivas usadas en
1216     esta sección se aplicarán a cualquier objeto con un nombre base
1217     (último componente del nombre de fichero) que coincida con el nombre de fichero especificado. Las
1218     secciones <code class="directive">&lt;Files&gt;</code> se
1219     procesan en el orden en que aparecen en el fichero de
1220     configuración, después de las secciones <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> y de leer los
1221     ficheros <code>.htaccess</code>, pero antes de las secciones
1222     <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Tenga en cuenta que las directivas <code class="directive">&lt;Files&gt;</code>
1223     pueden anidarse dentro de las secciones <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> para restringir la parte del
1224     sistema de ficheros a la que se aplican.</p>
1225
1226     <p>El argumento <var>filename</var> puede incluir un nombre de
1227     fichero, o una cadena de carácteres comodín, donde <code>?</code>
1228     equivale a cualquier carácter individual, y <code>*</code>
1229     equivale a cualquier secuencia de caracteres. También pueden
1230     usarse expresiones regulares extendidas, con la ventaja de que
1231     tambien se puede usar el carácter <code>~</code>. Por
1232     ejemplo:</p>
1233
1234     <div class="example"><p><code>
1235       &lt;Files ~ "\.(gif|jpe?g|png)$"&gt;
1236     </code></p></div>
1237
1238     <p>equivaldría a la mayoría de los formatos gráficos de
1239     Internet. No obstante, es mejor usar <code class="directive"><a href="#filesmatch">&lt;FilesMatch&gt;</a></code>.</p>
1240
1241     <p>Tenga en cuenta que a diferencia de las secciones <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> y <code class="directive"><a href="#location">&lt;Location&gt;</a></code>, las secciones
1242     <code class="directive">&lt;Files&gt;</code> pueden usarse dentro
1243     de los ficheros <code>.htaccess</code>. Esto permite a los
1244     usuarios controlar el acceso a sus propios archivos, a un nivel de
1245     fichero a fichero.</p>
1246
1247
1248 <h3>Consulte también</h3>
1249 <ul>
1250 <li><a href="../sections.html">Cómo funcionan las secciones
1251     &lt;Directory&gt;, &lt;Location&gt; and &lt;Files&gt; </a> para
1252     obtener una información más detallada sobre cómo se combinan estas
1253     diferentes secciones cuando se recibe una petición
1254 </li>
1255 </ul>
1256 </div>
1257 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1258 <div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch">&lt;FilesMatch&gt;</a> <a name="filesmatch" id="filesmatch">Directiva</a></h2>
1259 <table class="directive">
1260 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Contiene las directivas que se aplican a los ficheros
1261 cuyos nombres equivalen a las expresiones regulares que se especifiquen</td></tr>
1262 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>&lt;FilesMatch <var>regex</var>&gt; ... &lt;/FilesMatch&gt;</code></td></tr>
1263 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
1264 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>Todas</td></tr>
1265 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1266 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1267 </table>
1268     <p>La directiva <code class="directive">&lt;FilesMatch&gt;</code>
1269     limita el rango de las directivas incluidas según el nombre de los
1270     ficheros, como hace la directiva <code class="directive"><a href="#files">&lt;Files&gt;</a></code>. Sin embargo, acepta
1271     expresiones regulares. Por ejemplo:</p>
1272
1273     <div class="example"><p><code>
1274       &lt;FilesMatch "\.(gif|jpe?g|png)$"&gt;
1275     </code></p></div>
1276
1277     <p>equivaldría a la mayoría de los formatos gráficos de Internet.</p>
1278
1279 <h3>Consulte también</h3>
1280 <ul>
1281 <li><a href="../sections.html">Cómo funcionan las secciones
1282     &lt;Directory&gt;, &lt;Location&gt; and &lt;Files&gt;</a> para
1283     obtener información detallada sobre la forma en que estas
1284     secciones se combinan cuando se recibe una petición
1285 </li>
1286 </ul>
1287 </div>
1288 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1289 <div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a> <a name="forcetype" id="forcetype">Directiva</a></h2>
1290 <table class="directive">
1291 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Hace que todos los ficheros cuyos nombres tengan una equivalencia con con lo que se especifique sean
1292 servidos como contenido del tipo MIME que se establezca</td></tr>
1293 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>ForceType <var>MIME-type</var>|None</code></td></tr>
1294 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>directory, .htaccess</td></tr>
1295 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
1296 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1297 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1298 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>Perteneciente al núcleo del servidor a partir de la
1299 versión de Apache 2.0</td></tr>
1300 </table>
1301     <p>Cuando se usa en un fichero <code>.htaccess</code> o en una
1302     sección <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>, <code class="directive"><a href="#location">&lt;Location&gt;</a></code> o <code class="directive"><a href="#files">&lt;Files&gt;</a></code>, esta directiva hace que todos los
1303     ficheros cuyos nombres guarden una equivalencia con lo
1304     especificado sean servidos como contenido
1305     <var>MIME-type</var>. Por ejemplo, si tiene un directorio lleno de
1306     ficheros GIF, pero no quiere etiquetarlos con <code>.gif</code>,
1307     puede usar:</p>
1308
1309     <div class="example"><p><code>
1310       ForceType image/gif
1311     </code></p></div>
1312
1313     <p>Tenga en cuenta que a diferencia de <code class="directive"><a href="#defaulttype">DefaultType</a></code>, esta directiva prevalece sobre
1314     todas las asociaciones de tipo MIME, incluidas las extensiones de
1315     nombre de fichero que puedan identificar de qué tipo es un fichero.</p>
1316
1317     <p>Puede hacer que <code class="directive">ForceType</code> no prevalezca sobre el resto de directivas usando el valor <code>None</code>:</p>
1318
1319     <div class="example"><p><code>
1320       # forzar a todos los tipos de fichero a ser tratados como imagen/gif:<br />
1321       &lt;Location /images&gt;<br />
1322         <span class="indent">
1323           ForceType image/gif<br />
1324         </span>
1325       &lt;/Location&gt;<br />
1326       <br />
1327       # pero permitir la asociación de tipos MIME normal aquí:<br />
1328       &lt;Location /images/mixed&gt;<br />
1329       <span class="indent">
1330         ForceType None<br />
1331       </span>
1332       &lt;/Location&gt;
1333     </code></p></div>
1334
1335 </div>
1336 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1337 <div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a name="hostnamelookups" id="hostnamelookups">Directiva</a></h2>
1338 <table class="directive">
1339 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Activa la resolución de
1340 DNS de las direcciones IP de los clientes</td></tr>
1341 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
1342 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>HostnameLookups Off</code></td></tr>
1343 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory</td></tr>
1344 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1345 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1346 </table>
1347     <p>Esta directiva activa la resolución de DNS de manera que
1348     los nombres de host puedan ser guardados en los archivos log (y
1349     pasados a CGIs/SSIs en <code>REMOTE_HOST</code>).  El valor
1350     <code>Double</code> se refiere a hacer una busqueda de DNSs
1351     inversa doble. Esto es, después de hacer una busqueda
1352     inversa, se hace una busqueda normal posteriormente sobre ese
1353     resultado. Al menos una de las direcciones IP en la búsqueda
1354     posterior debe equivaler a la dirección IP original. (En
1355     terminología de "tcpwrappers" se llama
1356     <code>PARANOID</code>.)</p>
1357
1358     <p>Independientemente de lo que se especifique, cuando
1359     <code class="module"><a href="../mod/mod_access.html">mod_access</a></code> se usa para controlar el acceso por
1360     nombre de host, se hará una consulta inversa doble.  Esto se
1361     hace por seguridad. Tenga en cuenta que el resultado de una
1362     busqueda inversa doble no está disponible generalmente a no
1363     ser que especifique <code>HostnameLookups Double</code>. Por
1364     ejemplo, si especifica solo <code>HostnameLookups On</code> y se
1365     hace una petición a un objeto protegido por restricciones de
1366     nombre de host, independientemente de si la consulta inversa doble
1367     falla o no, el resultado de la consulta inversa simple se
1368     pasará a los CGIs en <code>REMOTE_HOST</code>.</p>
1369
1370     <p>El valor por defecto es <code>Off</code> para ahorrar
1371     tráfico de red en aquellos sitios web que realmente no
1372     necesitan hacer búsquedas inversas dobles. También es
1373     mejor para los usuarios finales porque no tienen que sufrir el
1374     retardo adicional que introducen las búsquedas.  Los sitios
1375     web con mucha carga deben usar en esta directiva el valor
1376     <code>Off</code>, porque las búsquedas de DNSs pueden
1377     consumir una cantidad de tiempo considerable. La utilidad
1378     <code class="program"><a href="../programs/logresolve.html">logresolve</a></code>, compilada por defecto en el
1379     subdirectorio <code>bin</code> de su directorio de
1380     instalación, puede usarse más tarde para buscar nombres
1381     de host en direcciones IP que estén en los logs cuando no
1382     esté en línea.</p>
1383
1384 </div>
1385 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1386 <div class="directive-section"><h2><a name="IdentityCheck" id="IdentityCheck">IdentityCheck</a> <a name="identitycheck" id="identitycheck">Directiva</a></h2>
1387 <table class="directive">
1388 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Activa que se registre en los archivos log la entidad RFC1413 del usuario remoto</td></tr>
1389 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>IdentityCheck On|Off</code></td></tr>
1390 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>IdentityCheck Off</code></td></tr>
1391 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory</td></tr>
1392 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1393 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1394 </table>
1395     <p>Esta directiva permite el almacenamiento en logs, según se
1396     especifica en el RFC1413, del nombre de usuario remoto para casda
1397     conexión cuando la máquina del cliente corra
1398     "identd" o un programa similar. Esta información se
1399     registra en el log de acceso.</p>
1400
1401     <p>La información que se registra con este procedimiento no
1402     debe ser considerada como fiable excepto para controles
1403     rudimentarios.</p>
1404
1405     <p>Tenga en cuenta que esto puede provocar serios problemas de
1406     retardo en los accesos a su servidor porque para cada
1407     petición hay que ejecutar una consulta de este tipo. Cuando
1408     hay firewalls involucrados, cada búsqueda puede probablemente
1409     fallar y añadir 30 segundos de retardo cada vez que se
1410     intenta un acceso. De modo que en general, su uso no es muy
1411     útil en servidores públicos accesibles desde
1412     Internet.</p>
1413
1414 </div>
1415 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1416 <div class="directive-section"><h2><a name="IfDefine" id="IfDefine">&lt;IfDefine&gt;</a> <a name="ifdefine" id="ifdefine">Directiva</a></h2>
1417 <table class="directive">
1418 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Engloba directivas que serán procesadas solo si se
1419 cumple una determinada condición al iniciar el servidor</td></tr>
1420 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>&lt;IfDefine [!]<var>parameter-name</var>&gt; ...
1421     &lt;/IfDefine&gt;</code></td></tr>
1422 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
1423 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>All</td></tr>
1424 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1425 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1426 </table>
1427     <p>La sección <code>&lt;IfDefine
1428     <var>test</var>&gt;...&lt;/IfDefine&gt; </code> se usa para marcar
1429     directivas que son condicionales. Las directivas que hay dentro de
1430     una sección <code class="directive">&lt;IfDefine&gt;</code> se
1431     procesan solo si <var>test</var> devuelve un resultado
1432     positivo. Si el <var> test</var> produce un resultado negativo,
1433     todo lo que haya entre los marcadores de comienzo y final
1434     será ignorado.</p>
1435
1436     <p>El <var>test</var> en la sección de directivas <code class="directive">&lt;IfDefine&gt;</code> puede tomar una de las
1437     siguientes dos formas:</p>
1438
1439     <ul>
1440       <li><var>parameter-name</var></li>
1441
1442       <li><code>!</code><var>parameter-name</var></li>
1443     </ul>
1444
1445     <p>En el primer caso, las directivas entre los marcadores de
1446     comienzo y final se procesan solo si el parámetro llamado
1447     <var>parameter-name</var> está definido. El segundo formato
1448     hace lo contrario, y procesa las directivas solo si
1449     <var>parameter-name</var> <strong>no</strong> está
1450     definido.</p>
1451
1452     <p>El argumento <var>parameter-name</var> se define cuando se
1453     ejecuta <code class="program"><a href="../programs/httpd.html">httpd</a></code> por la línea de comandos con la opción
1454     <code>-D<var>parameter</var></code>, al iniciar el servidor.</p>
1455
1456     <p>Las secciones <code class="directive">&lt;IfDefine&gt;</code>
1457     son anidables, lo cual puede usarse para implementar tests
1458     simples con varios parámetros. Ejemplo:</p>
1459
1460     <div class="example"><p><code>
1461       httpd -DReverseProxy ...<br />
1462       <br />
1463       # httpd.conf<br />
1464       &lt;IfDefine ReverseProxy&gt;<br />
1465       <span class="indent">
1466         LoadModule rewrite_module modules/mod_rewrite.so<br />
1467         LoadModule proxy_module   modules/libproxy.so<br />
1468       </span>
1469       &lt;/IfDefine&gt;
1470     </code></p></div>
1471
1472 </div>
1473 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1474 <div class="directive-section"><h2><a name="IfModule" id="IfModule">&lt;IfModule&gt;</a> <a name="ifmodule" id="ifmodule">Directiva</a></h2>
1475 <table class="directive">
1476 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Engloba directivas que se procesan de forma condicional
1477 según esté presente o ausente un módulo específico</td></tr>
1478 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>&lt;IfModule [!]<var>module-name</var>&gt; ...
1479     &lt;/IfModule&gt;</code></td></tr>
1480 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
1481 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>Todas</td></tr>
1482 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1483 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1484 </table>
1485     <p>La sección <code>&lt;IfModule
1486     <var>test</var>&gt;...&lt;/IfModule&gt;</code> se usa para marcar
1487     las directivas que se aplican si está presente un módulo
1488     específico. Las directivas dentro de una sección <code class="directive">&lt;IfModule&gt;</code> solo se procesan si el
1489     <var>test</var> produce un resultado positivo. Si el <var>test</var> da falso, todo
1490     lo que haya entre los marcadores de inicio y final es
1491     ignorado.</p>
1492
1493     <p>El <var>test</var> de las secciones <code class="directive">&lt;IfModule&gt;</code> puede tomar una de las siguientes
1494     formas:</p>
1495
1496     <ul>
1497       <li><var>module name</var></li>
1498
1499       <li>!<var>module name</var></li>
1500     </ul>
1501
1502     <p>En el primer caso, las directivas entre los marcadores de
1503     comienzo y final son procesados solo si el módulo llamado
1504     <var>module name</var> está incluido en Apache -- ya sea
1505     porque está compilado en el servidor o porque esté
1506     cargado dinámicamente usando <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>. El segundo formato hace lo contrario, y
1507     solo se procesan las directivas si el módulo <var>module
1508     name</var> <strong>no</strong> está incluido.</p>
1509
1510     <p>El argumento <var>module name</var> es  el nombre del fichero del
1511     módulo en el momento en que fue compilado. Por ejemplo,
1512     <code>mod_rewrite.c</code>.  Si un módulo consiste en varios
1513     archivos fuente, use el nombre del fichero que contenga la cadena
1514     de caracteres <code>STANDARD20_MODULE_STUFF</code>.</p>
1515
1516     <p>Las secciones <code class="directive">&lt;IfModule&gt;</code>
1517     son anidables, lo cual puede usarse para implementar tests simples
1518     con varios módulos.</p>
1519
1520     <div class="note">Esta sección debe usarse solo si necesita tener un
1521     fichero de configuración que funcione tanto si está como
1522     si no está un determinado módulo disponible. En
1523     condiciones normales, no es necesario usar directivas en
1524     secciones <code class="directive">&lt;IfModule&gt;</code>.</div>
1525
1526 </div>
1527 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1528 <div class="directive-section"><h2><a name="Include" id="Include">Include</a> <a name="include" id="include">Directiva</a></h2>
1529 <table class="directive">
1530 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Incluye otros ficheros de configuración dentro de
1531 los ficheros de configuración del servidor</td></tr>
1532 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>Include <var>file-path</var>|<var>directory-path</var></code></td></tr>
1533 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory</td></tr>
1534 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1535 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1536 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>Se pueden usar caracteres comodín para encontrar
1537 equivalencias en las versiones de Apache 2.0.41 y posteriores</td></tr>
1538 </table>
1539     <p>Esta directiva permite la inclusión de otros ficheros de
1540     configuración  dentro de los ficheros de configuración del
1541     servidor.</p>
1542
1543     <p>Los caracteres comodín de tipo shell (<code>fnmatch()</code>)
1544     pueden usarse para incluir varios ficheros de una vez por orden
1545     alfabético. Además, si <code class="directive">Include</code> apunta a un
1546     directorio, en lugar de a un fichero, Apache leerá todos los
1547     ficheros en ese directorio y sus subdirectorios. Sin embargo, no se
1548     recomienda incluir subdirectorios enteros, porque es fácil dejar
1549     accidentalmente ficheros temporales en un directorio y esto
1550     provocará que <code class="program"><a href="../programs/httpd.html">httpd</a></code> aborte.</p>
1551
1552     <p>La ruta del fichero especificada puede ser absoluta, o relativa
1553     a un directorio respecto al valor especificado en <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
1554
1555     <p>Ejemplos:</p>
1556
1557     <div class="example"><p><code>
1558       Include /usr/local/apache2/conf/ssl.conf<br />
1559       Include /usr/local/apache2/conf/vhosts/*.conf
1560     </code></p></div>
1561
1562     <p>O especificando rutas relativas al directorio <code class="directive"><a href="#serverroot">ServerRoot</a></code>:</p>
1563
1564     <div class="example"><p><code>
1565       Include conf/ssl.conf<br />
1566       Include conf/vhosts/*.conf
1567     </code></p></div>
1568
1569     <p>Si ejecuta <code>apachectl configtest</code> le aparecerá
1570     una lista con los ficheros que están siendo procesados
1571     durante la comprobación de la configuración:</p>
1572
1573     <div class="example"><p><code>
1574       root@host# apachectl configtest<br />
1575       Processing config file: /usr/local/apache2/conf/ssl.conf<br />
1576       Processing config file: /usr/local/apache2/conf/vhosts/vhost1.conf<br />
1577       Processing config file: /usr/local/apache2/conf/vhosts/vhost2.conf<br />
1578       Syntax OK
1579     </code></p></div>
1580
1581 <h3>Consulte también</h3>
1582 <ul>
1583 <li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li>
1584 </ul>
1585 </div>
1586 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1587 <div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a name="keepalive" id="keepalive">Directiva</a></h2>
1588 <table class="directive">
1589 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Permite que se establezcan conexiones HTTP
1590 persistentes</td></tr>
1591 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>KeepAlive On|Off</code></td></tr>
1592 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>KeepAlive On</code></td></tr>
1593 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
1594 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1595 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1596 </table>
1597     <p>La extensión Keep-Alive de HTTP/1.0 y la funcionalidad de
1598     conexión persistente de HTTP/1.1 facilitan la posibilidad de
1599     que se establezcan sesiones HTTP de larga duración que
1600     permiten que se puedan enviar múltiples peticiones sobre la
1601     misma conexión TCP. En algunos casos, esto tiene como
1602     resultado una reducción de casi el 50% en los tiempos de
1603     retardo en el caso de documentos con muchas imágenes. Para
1604     activar las conexiones Keep-Alive, especifique <code>KeepAlive
1605     On</code>.</p>
1606
1607     <p>Para clientes HTTP/1.0, las conexiones Keep-Alive se
1608     usarán solo si el cliente lo solicita
1609     específicamente. Además, una conexión Keep-Alive
1610     con un cliente HTTP/1.0 puede usarse solo cuando el tamaño
1611     del contenido es conocido con antelación. Esto implica que el
1612     contenido dinámico, como puede ser el resultado de un CGI,
1613     páginas SSI y listados de directorios generados por el
1614     servidor, no usarán por lo general conexiones Keep-Alive para
1615     clientes HTTP/1.0.  Para clientes HTTP/1.1, las conexiones
1616     persistentes son las que se usan por defecto a no ser que se
1617     especifique lo contrario. Si el cliente lo solicita, se usará
1618     @@@@@ chunked encoding @@@@@ para enviar contenido de tamaño
1619     desconocido sobre conexiones persistentes.</p>
1620
1621 <h3>Consulte también</h3>
1622 <ul>
1623 <li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li>
1624 </ul>
1625 </div>
1626 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1627 <div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a name="keepalivetimeout" id="keepalivetimeout">Directiva</a></h2>
1628 <table class="directive">
1629 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Tiempo que el servidor esperará peticiones subsiguientes
1630 en conexiones persistentes</td></tr>
1631 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>KeepAliveTimeout <var>seconds</var></code></td></tr>
1632 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>KeepAliveTimeout 15</code></td></tr>
1633 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
1634 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1635 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1636 </table>
1637     <p>Es el tiempo en segundos que Apache esperará peticiones
1638     subsiguientes antes de cerrar una conexión persistente. Una
1639     vez que una petición ha sido recibida, se aplica el valor
1640     especificado en la directiva <code class="directive"><a href="#timeout">Timeout</a></code> para cerrar la
1641     conexión.</p>
1642
1643     <p>Espeficificar un valor alto para
1644     <code class="directive">KeepAliveTimeout</code> puede provocar un menor
1645     rendimiento en servidores con mucha carga. Cuanto mayor sea el
1646     valor de timeout, mayor será el número de procesos del
1647     servidor se mantendrán ocupados esperando en conexiones con
1648     clientes no activos.</p>
1649
1650 </div>
1651 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1652 <div class="directive-section"><h2><a name="Limit" id="Limit">&lt;Limit&gt;</a> <a name="limit" id="limit">Directiva</a></h2>
1653 <table class="directive">
1654 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Restringe la aplicación de los controles de acceso incluidos a solo ciertos métodos HTTP</td></tr>
1655 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>&lt;Limit <var>method</var> [<var>method</var>] ... &gt; ...
1656     &lt;/Limit&gt;</code></td></tr>
1657 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
1658 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>Todas</td></tr>
1659 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1660 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1661 </table>
1662     <p>Los controles de acceso se aplican normalmente a
1663     <strong>todos</strong> los métodos de acceso, y este es el
1664     comportamiento que se busca casi siempre. <strong>En general, las
1665     directivas de control de acceso no deben estar dentro de una
1666     sección <code class="directive">&lt;Limit&gt;</code>.</strong></p>
1667
1668     <p>El propósito <code class="directive">&lt;Limit&gt;</code>
1669     es restringir el efecto de los controles de acceso a los
1670     métodos HTTP que se especifiquen. Para los demás
1671     métodos, las restricciones de acceso que estén incluidas
1672     en <code class="directive">&lt;Limit&gt;</code> <strong>no
1673     tendrán efecto</strong>. Los siguientes ejemplos aplican el
1674     control de acceso solo a los métodos <code>POST</code>,
1675     <code>PUT</code>, y <code>DELETE</code>, no afectando al resto de
1676     métodos:</p>
1677
1678     <div class="example"><p><code>
1679       &lt;Limit POST PUT DELETE&gt;<br />
1680       <span class="indent">
1681         Require valid-user<br />
1682       </span>
1683       &lt;/Limit&gt;
1684     </code></p></div>
1685
1686     <p>Los métodos incluidos en la lista pueden ser uno o
1687     más de los siguientes: <code>GET</code>,
1688     <code>POST</code>, <code>PUT</code>, <code>DELETE</code>,
1689     <code>CONNECT</code>, <code>OPTIONS</code>, <code>PATCH</code>,
1690     <code>PROPFIND</code>, <code>PROPPATCH</code>, <code>MKCOL</code>,
1691     <code>COPY</code>, <code>MOVE</code>, <code>LOCK</code>, y
1692     <code>UNLOCK</code>. <strong>Los nombres de los métodos
1693     distinguen mayúsculas de minúsculas.</strong> Si usa
1694     <code>GET</code> también se restringirán las peticiones
1695     <code>HEAD</code>. El método <code>TRACE</code> no puede
1696     limitarse.</p>
1697
1698     <div class="warning">Es mejor usar una sección <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code> en lugar de
1699     una sección <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> cuando se quiere restringir el
1700     acceso, porque una sección <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code> protege contra métodos
1701     arbitrarios.</div>
1702
1703
1704 </div>
1705 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1706 <div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept">&lt;LimitExcept&gt;</a> <a name="limitexcept" id="limitexcept">Directiva</a></h2>
1707 <table class="directive">
1708 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Restringe los controles de acceso a todos los métodos
1709 HTTP excepto a los que se especifiquen</td></tr>
1710 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>&lt;LimitExcept <var>method</var> [<var>method</var>] ... &gt;
1711     ...  &lt;/LimitExcept&gt;</code></td></tr>
1712 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
1713 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>Todas</td></tr>
1714 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1715 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1716 </table>
1717     <p><code class="directive">&lt;LimitExcept&gt;</code> y
1718     <code>&lt;/LimitExcept&gt;</code> se usan para englobar un grupo
1719     de directivas de control de acceso que se aplicarán a
1720     cualquier método de acceso HTTP <strong>no</strong>
1721     especificado en los argumentos; es lo contrario a lo
1722     que hace una sección <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> y puede usarse para controlar
1723     tanto métodos estándar como no estándar o
1724     métodos no reconocidos. Consulte la documentación de
1725     <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> para
1726     más detalles.</p>
1727
1728     <p>Por ejemplo:</p>
1729
1730     <div class="example"><p><code>
1731       &lt;LimitExcept POST GET&gt;<br />
1732       <span class="indent">
1733         Require valid-user<br />
1734       </span>
1735       &lt;/LimitExcept&gt;
1736     </code></p></div>
1737
1738
1739 </div>
1740 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1741 <div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a> <a name="limitinternalrecursion" id="limitinternalrecursion">Directiva</a></h2>
1742 <table class="directive">
1743 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Determina el número máximo de redirecciones internas y
1744 subpeticiones anidadas</td></tr>
1745 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>LimitInternalRecursion <var>number</var> [<var>number</var>]</code></td></tr>
1746 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
1747 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
1748 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1749 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1750 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>Disponible en las versiones Apache 2.0.47 y posteriores</td></tr>
1751 </table>
1752     <p>Una redirección interna ocurre, por ejemplo, cuando se usa
1753     la directiva <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code>,
1754     la cual internamente redirige la petición original a un
1755     script CGI. Una subpetición es un mecanismo de Apache para
1756     saber qué ocurriría si se produjera una petición a
1757     una URI.  Por ejemplo, <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> usa subpeticiones
1758     para buscar archivos especificados en la directiva <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>.</p>
1759
1760     <p><code class="directive">LimitInternalRecursion</code> hace que el
1761     servidor no sufra un error irrecuperable cuando entra en un ciclo
1762     infinito de redirecciones internas o subpeticiones. Tales ciclos
1763     se producen normalmente por errores de configuración.</p>
1764
1765     <p>La directiva guarda dos límites diferentes, los cuales se
1766     evalúan en para cada petición. El primer
1767     <var>número</var> es el número máximo de
1768     redirecciones internas, que pueden producirse una detrás de
1769     otra. El segundo <var>número</var> determina, la profundidad
1770     a la que subpeticiones pueden anidarse. Si especifica solo un
1771     <var>número</var>, se asignará a ambos límites.</p>
1772
1773     <div class="example"><h3>Ejemplo</h3><p><code>
1774       LimitInternalRecursion 5
1775     </code></p></div>
1776
1777 </div>
1778 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1779 <div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a name="limitrequestbody" id="limitrequestbody">Directiva</a></h2>
1780 <table class="directive">
1781 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Restringe el tamaño total del cuerpo de las peticiones
1782 HTTP enviadas desde el cliente</td></tr>
1783 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>LimitRequestBody <var>bytes</var></code></td></tr>
1784 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>LimitRequestBody 0</code></td></tr>
1785 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
1786 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>Todas</td></tr>
1787 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1788 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1789 </table>
1790     <p>Esta directiva especifica el número de <var>bytes</var>
1791     desde 0 (que significa sin límite) hasta 2147483647 (2GB) que
1792     se permite que tenga el cuerpo de una petición.</p>
1793
1794     <p>La directiva <code class="directive">LimitRequestBody</code> permite al
1795     usuario especificar un límite al tamaño del cuerpo del
1796     mensaje de las peticiones dentro del contexto en el que la
1797     directiva aparece (server, per-directory, per-file o
1798     per-location). Si la petición del cliente excede ese
1799     límite, el servidor devolverá una respuesta de error en
1800     lugar de servir la petición. El tamaño del cuerpo del
1801     mensaje de una petición normal varía mucho en
1802     función de la naturaleza del recurso y los métodos
1803     permitidos para ese recurso. Los scripts CGI usan normamente el
1804     cuerpo del mensaje para acceder la información de formularios
1805     HTML.  Las implementaciones del método <code>PUT</code>
1806     requerirán un valor al menos del mismo tamaño que
1807     cualquier representación que el servidor desee aceptar para
1808     ese recurso.</p>
1809
1810     <p>Esta directiva le da al administrador del servidor un mayor
1811     control sobre el comportamiento anormal de peticiones de clientes,
1812     lo cual puede ser útil para evitar algunos tipos de ataques de
1813     denegación de servicio.</p>
1814
1815     <p>Si, por ejemplo, permite que se suban archivos a una ubicación
1816     en concreto, y quiere limitar el tamaño de los ficheros que se
1817     suban a 100K, puede usar la siguiente directiva:</p>
1818
1819     <div class="example"><p><code>
1820       LimitRequestBody 102400
1821     </code></p></div>
1822
1823
1824 </div>
1825 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1826 <div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a name="limitrequestfields" id="limitrequestfields">Directiva</a></h2>
1827 <table class="directive">
1828 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Limita el número de campos de la cabecera de las
1829 peticiones HTTP del cliente que serán aceptadas</td></tr>
1830 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>LimitRequestFields <var>number</var></code></td></tr>
1831 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>LimitRequestFields 100</code></td></tr>
1832 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config</td></tr>
1833 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1834 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1835 </table>
1836     <p><var>Number</var> es un entero entre 0 (sin límite) hasta
1837     32767. El valor por defecto se define por la constante
1838     <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> al compilar (y es de 100
1839     campos para la cabecera).</p>
1840
1841     <p>La directiva <code class="directive">LimitRequestFields</code> permite
1842     al administrador del servidor modificar el límite del
1843     número de campos de la cabecera permitidos en una
1844     petición HTTP. Este valor tiene que ser mayor que el
1845     número de campos que tiene la cabecera de una petición
1846     normal de un cliente. El número de campos de la cabecera de
1847     una petición usados por un cliente raramente pasa de 20, pero
1848     esto puede variar según las diferentes implementaciones, a
1849     menudo dependiendo incluso de la configuración que un usuario
1850     haya hecho de su navegador para soportar negociación de
1851     contenidos detallada. Las extensiones opcionales de HTTP se
1852     expresan muchas veces usando campos de cabecera de
1853     petición.</p>
1854
1855     <p>Esta directiva le da al administrador del servidor un mayor
1856     control sobre el comportamiento anormal de peticiones de clientes,
1857     lo cual puede ser útil para evitar algunos tipos de ataques
1858     de denegación de servicio. Debe incrementar el valor que se
1859     especifica en esta directiva si a los clientes normales les llegan
1860     mensajes de error que indican que se han enviado demasiados campos
1861     de cabecera en la petición.</p>
1862
1863     <p>Por ejemplo:</p>
1864
1865     <div class="example"><p><code>
1866       LimitRequestFields 50
1867     </code></p></div>
1868
1869
1870 </div>
1871 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1872 <div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a name="limitrequestfieldsize" id="limitrequestfieldsize">Directiva</a></h2>
1873 <table class="directive">
1874 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Limita el tamaño permitido de las cabeceras de las peticiones HTTP de los clientes</td></tr>
1875 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>LimitRequestFieldsize <var>bytes</var></code></td></tr>
1876 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>LimitRequestFieldsize 8190</code></td></tr>
1877 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config</td></tr>
1878 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1879 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1880 </table>
1881     <p>Esta directiva especifica el número de <var>bytes</var>
1882     desde 0 hasta el valor de la constante definida al compilar
1883     <code>DEFAULT_LIMIT_REQUEST_FIELDSIZE</code> (8190 por defecto)
1884     que será permitido para una cabecera de las peticiones
1885     HTTP.</p>
1886
1887     <p>La directiva <code class="directive">LimitRequestFieldSize</code>
1888     permite al administrador del servidor reducir el límite del
1889     tamaño permitido de una cabecera de las peticiones HTTP por
1890     debajo del tamaño del buffer de entrada compilado en el
1891     servidor. Este valor tiene que ser lo suficientemente grande para
1892     que no quede por debajo del tamaño normal de una cabecera de
1893     petición de un cliente. El tamaño de una cabecera de una
1894     petición varía mucho en función de la
1895     implementación del cliente, a menudo depende incluso de la
1896     configuración del navegador que haya hecho el usuario para
1897     soportar negociación de contenido detallada.</p>
1898
1899     <p>Esta directiva le da al administrador del servidor un mayor
1900     control sobre el comportamiento anormal de peticiones de clientes,
1901     lo cual puede ser útil para evitar algunos tipos de ataques de
1902     denegación de servicio.</p>
1903
1904     <p>Por ejemplo:</p>
1905
1906     <div class="example"><p><code>
1907       LimitRequestFieldSize 4094
1908     </code></p></div>
1909
1910     <div class="note">En condiciones normales, no debe modificarse el valor que
1911     viene por defecto.</div>
1912
1913
1914 </div>
1915 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1916 <div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a name="limitrequestline" id="limitrequestline">Directiva</a></h2>
1917 <table class="directive">
1918 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Limita el tamaño la línea de petición HTTP que será
1919 aceptada</td></tr>
1920 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>LimitRequestLine <var>bytes</var></code></td></tr>
1921 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
1922 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config</td></tr>
1923 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1924 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1925 </table>
1926     <p>Esta directiva especifica el número de <var>bytes</var> de
1927     0 hasta el valor de la constante definida al compilar
1928     <code>DEFAULT_LIMIT_REQUEST_LINE</code> ( @@@@ 8190 as distributed @@@@ ) que
1929     se permitirá para la línea de petición HTTP.</p>
1930
1931     <p>La directiva <code class="directive">LimitRequestLine</code> permite al
1932     administrador del servidor reducir el límite de tamaño
1933     permitido de la línea de petición de las peticiones HTTP
1934     de los clientes por debajo del tamaño del buffer de entrada
1935     compilado con el servidor. Como la línea de petición
1936     consiste en el método HTTP, la URI y la versión del
1937     protocolo, la directiva <code class="directive">LimitRequestLine</code>
1938     impone una restricción en la longitud de la URI de la
1939     petición permitida por el servidor. Este valor tiene que ser
1940     lo suficientemente grande como para que admita el tamaño de
1941     sus nombres de recurso, incluida la información que puede
1942     ser pasada como parte de consulta de una petición
1943     <code>GET</code>.</p>
1944
1945     <p>Esta directiva le da al administrador del servidor un mayor
1946     control sobre el comportamiento anormal de peticiones de clientes,
1947     lo cual puede ser útil para evitar algunos tipos de ataques de
1948     denegación de servicio.</p>
1949
1950     <p>Por ejemplo:</p>
1951
1952     <div class="example"><p><code>
1953       LimitRequestLine 4094
1954     </code></p></div>
1955
1956     <div class="note">En condiciones normales, no debe modificarse el valor que
1957     viene por defecto.</div>
1958
1959 </div>
1960 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1961 <div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a name="limitxmlrequestbody" id="limitxmlrequestbody">Directiva</a></h2>
1962 <table class="directive">
1963 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Limita el tamaño del cuerpo de una petición XML</td></tr>
1964 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>LimitXMLRequestBody <var>bytes</var></code></td></tr>
1965 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
1966 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
1967 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>All</td></tr>
1968 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1969 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1970 </table>
1971     <p>Límite (en bytes) o tamaño máximo del cuerpo de una petición
1972     basada en XML. Si se especifica el valor <code>0</code> se
1973     desactiva este control.</p>
1974
1975     <p>Ejemplo:</p>
1976
1977     <div class="example"><p><code>
1978       LimitXMLRequestBody 0
1979     </code></p></div>
1980
1981
1982 </div>
1983 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1984 <div class="directive-section"><h2><a name="Location" id="Location">&lt;Location&gt;</a> <a name="location" id="location">Directiva</a></h2>
1985 <table class="directive">
1986 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Aplica las directivas que contiene solo a las URLs que tengan una equivalencia con los valores que se especifiquen</td></tr>
1987 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>&lt;Location
1988     <var>URL-path</var>|<var>URL</var>&gt; ... &lt;/Location&gt;</code></td></tr>
1989 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
1990 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
1991 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
1992 </table>
1993     <p>Una sección <code class="directive">&lt;Location&gt;</code>
1994     aplica las directivas que contiene según la URL de que se
1995     trate. Es parecida a la directiva <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>, y tiene que terminar con una
1996     directiva <code>&lt;/Location&gt;</code>. Las secciones <code class="directive">&lt;Location&gt;</code> se procesan en el orden en que
1997     aparecen en el fichero de configuración, después de leer
1998     las secciones <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> y los ficheros
1999     <code>.htaccess</code>, y después de las secciones <code class="directive"><a href="#files">&lt;Files&gt;</a></code>.</p>
2000
2001     <p>Las secciones <code class="directive">&lt;Location&gt;</code>
2002     operan completamente fuera del sistema de ficheros.  Esto tiene
2003     varias consecuencias. La más importante, es que las
2004     directivas <code class="directive">&lt;Location&gt;</code> no deben
2005     usarse para controlar el acceso a ubicaciones del sistema de
2006     ficheros. Como diferentes URLs pueden corresponderse con una misma
2007     ubicación de un sistema de ficheros, tales controles de
2008     acceso pueden ser burlados.</p>
2009
2010     <div class="note"><h3>Cuándo usar <code class="directive">&lt;Location&gt;</code></h3>
2011
2012     <p>Use <code class="directive">&lt;Location&gt;</code> para aplicar
2013     las directivas que va a incluir a contenido que está fuera
2014     del sistema de ficheros.  Para el contenido que esté en el
2015     sistema de ficheros, use <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> y <code class="directive"><a href="#files">&lt;Files&gt;</a></code>.  Una excepción a esto es el
2016     uso de <code>&lt;Location /&gt;</code>, que es un modo fácil
2017     de aplicar una configuración a un servidor entero.</p>
2018     </div>
2019
2020     <p>Para todas las peticiones que no provengan de servidores proxy,
2021     la URL de la que se buscan equivalencias es una ruta URL de la
2022     forma <code>/path/</code>.  Ningún esquema, nombre de host,
2023     puerto o cadena de consulta puede incluirse.  Para peticiones
2024     provenientes de servidores proxy, la URL de la que se buscan
2025     euivalencias es de la forma <code>scheme://servername/path</code>,
2026     y debe incluir el prefijo.</p>
2027
2028     <p>La URL puede usar caracteres comodín. En una cadena de
2029     caracteres comodín, <code>?</code> equivale a cualquier
2030     carácter, y <code>*</code> equivale a cualquier secuencia de
2031     caracteres.</p>
2032
2033     <p>También pueden usarse expresiones regulares extendidas,
2034     con el carácter adicional <code>~</code>. Por ejemplo:</p>
2035
2036     <div class="example"><p><code>
2037       &lt;Location ~ "/(extra|special)/data"&gt;
2038     </code></p></div>
2039
2040     <p>equivaldrá a las URLs que contengan la subcadena
2041     <code>/extra/data</code> o <code>/special/data</code>. La
2042     directiva <code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code> se comporta de igual modo
2043     que la versión de regex de <code class="directive">&lt;Location&gt;</code>.</p>
2044
2045     <p>El uso de <code class="directive">&lt;Location&gt;</code> es
2046     especialmente útil cuando se combina con la directiva
2047     <code class="directive"><a href="#sethandler">SetHandler</a></code>. Por ejemplo, para
2048     permitir peticiones de status, pero solo de navegadores que
2049     intenten acceder a <code>foo.com</code>, puede usar:</p>
2050
2051     <div class="example"><p><code>
2052       &lt;Location /status&gt;<br />
2053       <span class="indent">
2054         SetHandler server-status<br />
2055         Order Deny,Allow<br />
2056         Deny from all<br />
2057         Allow from .foo.com<br />
2058       </span>
2059       &lt;/Location&gt;
2060     </code></p></div>
2061
2062     <div class="note"><h3>Comentarios sobre la barra : /</h3> <p>El
2063       carácter de la barra tiene un significado especial
2064       dependiendo del lugar donde aparece en una URL. Los usuarios
2065       puede estar no estar acostumbrada a que la barra tenga distintos
2066       significados, por ejemplo, en los sistemas de ficheros, varias
2067       barras consecutivas tienen el mismo significado que una sola
2068       barra (por ejemplo, <code>/home///foo</code> es lo mismo que
2069       <code>/home/foo</code>). Para las URL's esto no se cumple.  La
2070       directiva <code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code> y la versión de
2071       regex de <code class="directive">&lt;Location&gt;</code>
2072       requieren que se especifiquen explícitamente múltiples
2073       barras solo si esa es su intención.</p>
2074
2075       <p>Por ejemplo, <code>&lt;LocationMatch ^/abc&gt;</code>
2076       podría equivaler a la petición de la URL
2077       <code>/abc</code> pero no a la petición de la URL <code>
2078       //abc</code>. La directiva (no regex) <code class="directive">&lt;Location&gt;</code> se comporta de manera similar cuando se
2079       usa para peticiones provenientes de servidores proxy. Sin
2080       embargo, cuando la directiva (no regex) <code class="directive">&lt;Location&gt;</code> se usa para peticiones no
2081       provenientes de servidores proxy, a efectos de encontrar
2082       equivalencias, múltiples barras equivaldrán a una
2083       sola. Por ejemplo, si especifica <code>&lt;Location
2084       /abc/def&gt;</code> y la petición es a
2085       <code>/abc//def</code> se producirá equivalencia.</p>
2086     </div>
2087
2088 <h3>Consulte también</h3>
2089 <ul>
2090 <li><a href="../sections.html">Cómo funcionan las secciones
2091     &lt;Directory&gt;, &lt;Location&gt; y &lt;Files&gt; </a> si quiere
2092     obtener una información detallada sobre cómo se combinan
2093     esas secciones cuando se recibe una petición</li>
2094 </ul>
2095 </div>
2096 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2097 <div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch">&lt;LocationMatch&gt;</a> <a name="locationmatch" id="locationmatch">Directiva</a></h2>
2098 <table class="directive">
2099 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Aplica las directiva que incluye solo a las URLs que tengan equivalencia con alguna de las expresiones regulares que se especifiquen</td></tr>
2100 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>&lt;LocationMatch
2101     <var>regex</var>&gt; ... &lt;/LocationMatch&gt;</code></td></tr>
2102 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
2103 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2104 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2105 </table>
2106     <p>La directiva <code class="directive">&lt;LocationMatch&gt;</code> limita la aplicación
2107     de las directivas que incluye a URLs que tengan equivalencia con
2108     alguna de las expresiones regulares que se especifican, de manera
2109     idéntica a como lo hace <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Sin embargo, toma las
2110     expresiones regulares como argumentos en lugar de como una cadena
2111     de caracteres. Por ejemplo:</p>
2112
2113     <div class="example"><p><code>
2114       &lt;LocationMatch "/(extra|special)/data"&gt;
2115     </code></p></div>
2116
2117     <p>equivaldría a las URLs que contengan la subcadena
2118     <code>/extra/data</code> ó <code>/special/data</code>.</p>
2119
2120 <h3>Consulte también</h3>
2121 <ul>
2122 <li><a href="../sections.html">Cómo funcionan las secciones
2123     &lt;Directory&gt;, &lt;Location&gt; y &lt;Files&gt; </a> si quiere
2124     obtener una explicación detallada de cómo se combinan
2125     esas secciones cuando se recibe una petición</li>
2126 </ul>
2127 </div>
2128 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2129 <div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a> <a name="loglevel" id="loglevel">Directiva</a></h2>
2130 <table class="directive">
2131 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Controla la extensión de los mensajes que se almacenan
2132 en el ErrorLog</td></tr>
2133 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>LogLevel <var>level</var></code></td></tr>
2134 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>LogLevel warn</code></td></tr>
2135 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
2136 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2137 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2138 </table>
2139     <p><code class="directive">LogLevel</code> especifica el nivel al que se
2140     detallan los errores que se almacenan en los logs de errores
2141     (consulte la directiva <code class="directive"><a href="#errorlog">ErrorLog</a></code>). Los <var>niveles</var>
2142     (levels) disponibles son, por orden decreciente:</p>
2143
2144     <table class="bordered">
2145
2146       <tr>
2147         <th><strong>Level</strong> </th>
2148
2149         <th><strong>Description</strong> </th>
2150
2151         <th><strong>Example</strong> </th>
2152       </tr>
2153
2154       <tr>
2155         <td><code>emerg</code> </td>
2156
2157         <td>Emergencias - sistema inutilizable.</td>
2158
2159         <td>"Un proceso hijo no puede abrir el fichero de lock (lock
2160         file). El programa va a terminar"</td>
2161       </tr>
2162
2163       <tr>
2164         <td><code>alert</code> </td>
2165
2166         <td>Debe hacer algo inmediatamente.</td>
2167
2168         <td>"getpwuid: no pudo determinar el nombre de usuario a partir del uid"</td>
2169       </tr>
2170
2171       <tr>
2172         <td><code>crit</code> </td>
2173
2174         <td>Condiciones críticas.</td>
2175
2176         <td>"socket: No se encontró un socket adecuado, el proceso hijo va a terminar"</td>
2177       </tr>
2178
2179       <tr>
2180         <td><code>error</code> </td>
2181
2182         <td>Condiciones de error.</td>
2183
2184         <td>"Final prematuro de la cabecera del script""</td>
2185       </tr>
2186
2187       <tr>
2188         <td><code>warn</code> </td>
2189
2190         <td>Condiciones de advertencia.</td>
2191
2192         <td>"el proceso hijo 1234 no ha terminado, enviando otra vez
2193         SIGHUP"</td>
2194       </tr>
2195
2196       <tr>
2197         <td><code>notice</code> </td>
2198
2199         <td>Condición normal, pero significativa.</td>
2200
2201         <td>"httpd: interceptada señal SIGBUS, intentando hacer
2202         un volcado de memoria en ..."</td>
2203       </tr>
2204
2205       <tr>
2206         <td><code>info</code> </td>
2207
2208         <td>Información.</td>
2209
2210         <td>"El servidor parece estar ocupado, (puede que necesite incrementar
2211         StartServers, o Min/MaxSpareServers)..."</td>
2212       </tr>
2213
2214       <tr>
2215         <td><code>debug</code> </td>
2216
2217         <td>Mensajes de nivel debug</td>
2218
2219         <td>"Abriendo el fichero de configuración ..."</td>
2220       </tr>
2221     </table>
2222
2223     <p>Cuando se especifica un determinado nivel, se escriben en el
2224     log también los mensajes de todos los demás niveles por
2225     encima.  Por ejemplo, cuando se especifica <code>LogLevel
2226     info</code>, también se escribirán en el log los
2227     mensajes de los niveles <code>notice</code> y
2228     <code>warn</code>.</p>
2229
2230     <p>Se recomienda usar, al menos, el nivel <code>crit</code>.</p>
2231
2232     <p>Por ejemplo:</p>
2233
2234     <div class="example"><p><code>
2235       LogLevel notice
2236     </code></p></div>
2237
2238     <div class="note"><h3>Nota</h3> <p>Cuando el fichero log es un fichero
2239       normal y se escriben en el mensajes de nivel
2240       <code>notice</code>, estos mensajes no podrán ser
2241       borrados. Sin embargo, esto no se aplica cuando se usa
2242       <code>syslog</code>.</p>
2243     </div>
2244
2245 </div>
2246 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2247 <div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a> <a name="maxkeepaliverequests" id="maxkeepaliverequests">Directiva</a></h2>
2248 <table class="directive">
2249 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Número de peticiones permitidas en una conexión
2250 persistente</td></tr>
2251 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>MaxKeepAliveRequests <var>number</var></code></td></tr>
2252 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
2253 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
2254 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2255 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2256 </table>
2257     <p>La directiva <code class="directive">MaxKeepAliveRequests</code> limita
2258     el número de peticiones permitidas por conexión cuando
2259     <code class="directive"><a href="#keepalive">KeepAlive</a></code> está
2260     activado. Si se especifica el valor <code>0</code>, el número
2261     de peticiones permitidas es ilimitado. Se recomienda que en esta
2262     directiva se especifique un valor alto para obtener el máximo
2263     rendimiento del servidor.</p>
2264
2265     <p>Por ejemplo:</p>
2266
2267     <div class="example"><p><code>
2268       MaxKeepAliveRequests 500
2269     </code></p></div>
2270
2271 </div>
2272 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2273 <div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a name="namevirtualhost" id="namevirtualhost">Directiva</a></h2>
2274 <table class="directive">
2275 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Designa una dirección IP para usar hosting virtual basado en nombres</td></tr>
2276 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>NameVirtualHost <var>addr</var>[:<var>port</var>]</code></td></tr>
2277 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config</td></tr>
2278 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2279 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2280 </table>
2281     <p>Es necesario usar la directiva
2282     <code class="directive">NameVirtualHost</code> es necesario usarla si
2283     quiere configurar <a href="../vhosts/">hosts virtuales basados en
2284     nombres</a>.</p>
2285
2286     <p>Aunque <var>addr</var> puede ser un nombre de host, se
2287     recomienda que use siempre una dirección IP, por ejemplo:</p>
2288
2289     <div class="example"><p><code>
2290       NameVirtualHost 111.22.33.44
2291     </code></p></div>
2292
2293     <p>Con la directiva <code class="directive">NameVirtualHost</code> se
2294     especifica la dirección IP en la cual el servidor
2295     recibirá las peticiones para los hosts virtuales basados en
2296     nombres. Bsta será normalmente la dirección a la cual su
2297     host virtual basado en nombres se resuelve. En los casos en que en
2298     las peticiones las recibe un firewall (cortafuegos) o un proxy y
2299     las redirige a una dirección IP diferente del servidor, debe
2300     especificar la dirección IP del adaptador de red físico
2301     de la máquina que servirá las peticiones. Si tiene
2302     múltiples hosts basados en nombres o múltiples
2303     direcciones, repita la directiva para cada dirección.</p>
2304
2305     <div class="note"><h3>Nota</h3>
2306        <p>Tenga en cuenta, que el "servidor principal" y cualquier
2307       servidor <code>_default_</code> <strong>nunca</strong>
2308       servirán una petición a un dirección IP
2309       <code class="directive">NameVirtualHost</code> (a menos que por alguna
2310       razón use <code class="directive">NameVirtualHost</code> pero no
2311       especifique ningún <code class="directive">VirtualHost</code> para
2312       esa dirección).</p>
2313     </div>
2314
2315     <p>De manera opcional puede especificar un número de puerto en
2316     el que debe usarse el host virtual basado en el nombre, por
2317     ejemplo</p>
2318
2319     <div class="example"><p><code>
2320       NameVirtualHost 111.22.33.44:8080
2321     </code></p></div>
2322
2323     <p>Las direcciones IPv6 deben escribirse entre corchetes, como se
2324     muestra en el siguiente ejemplo:</p>
2325
2326     <div class="example"><p><code>
2327       NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
2328     </code></p></div>
2329
2330     <p>Para recibir peticiones en todas las interfaces de red, puede
2331     usar <code>*</code> como argumento</p>
2332
2333     <div class="example"><p><code>
2334       NameVirtualHost *
2335     </code></p></div>
2336
2337     <div class="note"><h3>Argumento de la directiva <code class="directive">&lt;VirtualHost&gt;</code></h3>
2338       <p>Tenga en cuenta que el argumento de la directiva <code class="directive">&lt;VirtualHost&gt;</code> debe coincidir
2339        exactamente con el de la directiva <code class="directive">NameVirtualHost</code>.</p>
2340
2341       <div class="example"><p><code>
2342         NameVirtualHost 1.2.3.4<br />
2343         &lt;VirtualHost 1.2.3.4&gt;<br />
2344         # ...<br />
2345         &lt;/VirtualHost&gt;<br />
2346       </code></p></div>
2347     </div>
2348
2349 <h3>Consulte también</h3>
2350 <ul>
2351 <li><a href="../vhosts/">Documentación sobre hosting
2352 virtual</a></li>
2353 </ul>
2354 </div>
2355 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2356 <div class="directive-section"><h2><a name="Options" id="Options">Options</a> <a name="options" id="options">Directiva</a></h2>
2357 <table class="directive">
2358 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Configura las funcionalidades disponibles en un directorio en particular</td></tr>
2359 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>Options
2360     [+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr>
2361 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>Options All</code></td></tr>
2362 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
2363 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>Options</td></tr>
2364 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2365 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2366 </table>
2367     <p>La directiva <code class="directive">Options</code> controla qué
2368     funcionalidades del servidor están disponibles en un
2369     directorio en particular.</p>
2370
2371     <p>En <var>option</var> puede especificar <code>None</code>, en
2372     cuyo caso ninguna funcionalidad adicional estará activada, o
2373     puede especificar una o más de las siguientes opciones:</p>
2374
2375     <dl>
2376       <dt><code>All</code></dt>
2377
2378       <dd>Todas las opciones excepto <code>MultiViews</code>. Este es
2379       el valor por defecto.</dd>
2380
2381       <dt><code>ExecCGI</code></dt>
2382
2383       <dd>Se permite la ejecución de scripts CGI usando
2384       <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>.</dd>
2385
2386       <dt><code>FollowSymLinks</code></dt>
2387
2388       <dd>
2389
2390       El servidor seguirá los enlaces simbólicos en este
2391       directorio
2392       <div class="note">
2393       <p>Aunque el servidor siga los enlaces simbólicos, eso
2394       <em>no</em> cambia la ruta usada para encontrar equivalencias en
2395       las secciones <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>.</p> <p>Tenga en cuenta
2396       también que esta opción <strong>es ignorada</strong> si está
2397       dentro de una sección <code class="directive"><a href="#location">&lt;Location&gt;</a></code>.</p> </div></dd>
2398
2399       <dt><code>Includes</code></dt>
2400
2401       <dd>
2402       Permite el uso de Server-side includes, del módulo <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>.</dd>
2403
2404       <dt><code>IncludesNOEXEC</code></dt>
2405
2406       <dd>
2407
2408       Permite el uso de Server-side includes, pero <code>#exec cmd</code>
2409       y <code>#exec cgi</code> son desactivados. Aunque es posible
2410       <code>#include virtual</code> (incluir de forma virtual) scripts
2411       CGI desde directorios especificados con <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>.</dd>
2412
2413       <dt><code>Indexes</code></dt>
2414
2415       <dd>
2416       Si se produce una petición a una URL que se corresponde con un directorio,
2417       y no hay <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>
2418       (por ejemplo, <code>index.html</code>) en ese directorio,
2419       entonces <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> devolverá una lista con
2420       los contenidos del directorio.</dd>
2421
2422       <dt><code>MultiViews</code></dt>
2423
2424       <dd>
2425       Se permiten "MultiViews" de <a href="../content-negotiation.html">contenido negociado</a>
2426       "MultiViews" usando <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>.</dd>
2427
2428       <dt><code>SymLinksIfOwnerMatch</code></dt>
2429
2430       <dd>El servidor seguirá los enlaces simbólicos en los que el
2431       fichero o directorio final pertenezca al mismo usuario que el
2432       enlace.
2433
2434       <div class="note"><h3>Nota</h3> Esta opción es ignorada si se pone
2435       dentro de una sección <code class="directive"><a href="#location">&lt;Location&gt;</a></code>.</div>
2436       </dd>
2437     </dl>
2438
2439     <p>Normalmente, si se pueden aplicar múltiples
2440     <code class="directive">Options</code> a un directorio, entonces la
2441     más específica se aplica y las demás se ignoran;
2442     las opciones no se fusionan. (Consulte <a href="../sections.html#mergin">cómo se fusionan las
2443     secciones</a>.)  Sin embargo, si <em>todas</em> las opciones en la
2444     directiva <code class="directive">Options</code> van precedidas de un
2445     símbolo <code>+</code> o <code>-</code>, las opciones se
2446     fusionan. Cualquier opción precedida de un <code>+</code> se
2447     añade a las opciones en ese momento activas, y las opciones
2448     precedidas de un <code>-</code> se quitan de las activas en ese
2449     momento. </p>
2450
2451     <p>Por ejemplo, sin ningún símbolo <code>+</code> o
2452     <code>-</code>:</p>
2453
2454     <div class="example"><p><code>
2455       &lt;Directory /web/docs&gt;<br />
2456       <span class="indent">
2457         Options Indexes FollowSymLinks<br />
2458       </span>
2459       &lt;/Directory&gt;<br />
2460       <br />
2461       &lt;Directory /web/docs/spec&gt;<br />
2462       <span class="indent">
2463         Options Includes<br />
2464       </span>
2465       &lt;/Directory&gt;
2466     </code></p></div>
2467
2468     <p>entoces solo <code>Includes</code> tendrá efecto para el
2469     directorio <code>/web/docs/spec</code>. Sin embargo, si la segunda
2470     directiva <code class="directive">Options</code> usara un símbolo
2471     <code>+</code> y otro <code>-</code>:</p>
2472
2473     <div class="example"><p><code>
2474       &lt;Directory /web/docs&gt;<br />
2475       <span class="indent">
2476         Options Indexes FollowSymLinks<br />
2477       </span>
2478       &lt;/Directory&gt;<br />
2479       <br />
2480       &lt;Directory /web/docs/spec&gt;<br />
2481       <span class="indent">
2482         Options +Includes -Indexes<br />
2483       </span>
2484       &lt;/Directory&gt;
2485     </code></p></div>
2486
2487     <p>entonces las opciones <code>FollowSymLinks</code> e
2488     <code>Includes</code> estarán activas para el directorio
2489     <code>/web/docs/spec</code>.</p>
2490
2491
2492     <div class="note"><h3>Nota</h3>
2493       <p>El uso de <code>-IncludesNOEXEC</code> o <code>-Includes</code>
2494       desactiva server-side includes completamente independientemente
2495       de la configuración anterior.</p>
2496     </div>
2497
2498     <p>El comportamiento por defecto en ausencia de ninguna
2499     configuración es <code>All</code>.</p>
2500
2501 </div>
2502 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2503 <div class="directive-section"><h2><a name="Require" id="Require">Require</a> <a name="require" id="require">Directiva</a></h2>
2504 <table class="directive">
2505 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Selecciona qué usuarios autentificados pueden acceder a
2506 un recurso</td></tr>
2507 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>Require <var>entity-name</var> [<var>entity-name</var>] ...</code></td></tr>
2508 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>directory, .htaccess</td></tr>
2509 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>AuthConfig</td></tr>
2510 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2511 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2512 </table>
2513     <p>Esta directiva selecciona qué usuarios autentificados pueden
2514     acceder a un recurso. La sintaxis a usar es:</p>
2515
2516     <dl>
2517       <dt><code>Require user <var>userid</var> [<var>userid</var>]
2518       ...</code></dt>
2519       <dd>Solo los usuarios mencionados pueden acceder al
2520       recurso.</dd>
2521
2522       <dt><code>Require group <var>group-name</var> [<var>group-name</var>]
2523       ...</code></dt>
2524       <dd>Solo los usuarios pertenecientes a los grupos mencionados
2525       pueden acceder al recurso.</dd>
2526
2527       <dt><code>Require valid-user</code></dt>
2528       <dd>Todos los usarios pueden acceder al recurso.</dd>
2529     </dl>
2530
2531     <p><code class="directive">Require</code> debe ser usada de forma conjunta
2532     con las directivas <code class="directive"><a href="#authname">AuthName</a></code>,
2533     <code class="directive"><a href="#authtype">AuthType</a></code>, y con directivas
2534     como <code class="directive"><a href="../mod/mod_auth.html#authuserfile">AuthUserFile</a></code> y
2535     <code class="directive"><a href="../mod/mod_auth.html#authgroupfile">AuthGroupFile</a></code> (para
2536     definir usuarios y grupos) para funcionar
2537     correctamente. Ejemplo:</p>
2538
2539     <div class="example"><p><code>
2540        AuthType Basic<br />
2541        AuthName "Restricted Resource"<br />
2542        AuthUserFile /web/users<br />
2543        AuthGroupFile /web/groups<br />
2544        Require group admin
2545     </code></p></div>
2546
2547     <p>Los controles de acceso que se aplican de esta manera son
2548     efectivos para <strong>todos</strong> los
2549     métodos. <strong>Esto es lo que normalmente se
2550     quiere.</strong> Si quiere aplicar controles de acceso solo a
2551     métodos específicos, mientras se dejan otros
2552     métodos sin protección, use la directiva
2553     <code class="directive">Require</code> en una sección <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code>.</p>
2554
2555 <h3>Consulte también</h3>
2556 <ul>
2557 <li><code class="directive"><a href="#satisfy">Satisfy</a></code></li>
2558 <li><code class="module"><a href="../mod/mod_access.html">mod_access</a></code></li>
2559 </ul>
2560 </div>
2561 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2562 <div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a name="rlimitcpu" id="rlimitcpu">Directiva</a></h2>
2563 <table class="directive">
2564 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Limita el consumo de tiempo de CPU que pueden hacer proceses creados
2565 por procesos hijo de Apache</td></tr>
2566 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>RLimitCPU <var>seconds</var>|max [<var>seconds</var>|max]</code></td></tr>
2567 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>Unset; usa el valor por defecto del sistema operativo</code></td></tr>
2568 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
2569 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>Todas</td></tr>
2570 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2571 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2572 </table>
2573     <p>Toma 1 ó 2 parámetros. El primer parámetro
2574     se refiere al límite flexible de recursos para todos los
2575     procesos y el segundo parámetro especifica el límite
2576     máximo de recursos. Cada uno de los parámetros puede ser
2577     un número, ó <code>max</code> para indicarle al servidor que
2578     el límite debe fijarse al máximo permitido por la
2579     configuración del sistema operativo. Para elevar el
2580     límite máximo de recursos es necesario que se esté
2581     ejecutando el servidor como ususario <code>root</code>, o estar en
2582     la fase inicial del arranque.</p>
2583
2584     <p>Esto se aplica a procesos nacidos de procesos hijo de Apache
2585     que están sirviendo peticiones, no a los procesos hijo de
2586     Apache propiamente dichos. Esto incluye a los scripts CGI y a los
2587     comandos de ejecución SSI, pero no a procesos nacidos del
2588     proceso padre Apache tales como ficheros de registro
2589     redireccionados (piped logs).</p>
2590
2591     <p>Los límites de consumo de tiempo de la CPU se expresan en
2592     segundos por proceso.</p>
2593
2594 <h3>Consulte también</h3>
2595 <ul>
2596 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2597 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2598 </ul>
2599 </div>
2600 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2601 <div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a name="rlimitmem" id="rlimitmem">Directiva</a></h2>
2602 <table class="directive">
2603 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Limita el consumo de memoria que pueden hacer procesos creados por procesos hijo de Apache</td></tr>
2604 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>RLimitMEM <var>bytes</var>|max [<var>bytes</var>|max]</code></td></tr>
2605 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>Unset; usa el valor por defecto del sistema operativo</code></td></tr>
2606 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
2607 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>Todas</td></tr>
2608 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2609 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2610 </table>
2611     <p>Toma 1 ó 2 parámetros. El primer parámetro
2612     especifica el límite flexible de recursos para todos los
2613     procesos y el segundo parámetro especifica el límite
2614     máximo de recursos. Cada uno de los parámetros puede ser
2615     un número, ó <code>max</code> para indicarle al servidor que
2616     el límite debe fijarse al máximo permitido por la
2617     configuración del sistema operativo. Para elevar el
2618     límite máximo de recursos es necesario que se esté
2619     ejecutando el servidor como ususario <code>root</code>, o estar en
2620     la fase inicial del arranque.</p>
2621
2622     <p>Esto se aplica a procesos nacidos de procesos hijo de Apache
2623     que están sirviendo peticiones, no a los procesos hijo de
2624     Apache propiamente dichos. Esto incluye a los scripts CGI y a los
2625     comandos de ejecución SSI, pero no a procesos nacidos del
2626     proceso padre Apache tales como ficheros de registro
2627     redireccionados (piped logs).</p>
2628
2629     <p>Los límites de consumo de memoria se expresan en bytes por
2630     proceso.</p>
2631
2632 <h3>Consulte también</h3>
2633 <ul>
2634 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2635 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2636 </ul>
2637 </div>
2638 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2639 <div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a name="rlimitnproc" id="rlimitnproc">Directiva</a></h2>
2640 <table class="directive">
2641 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Limita el número de procesos que pueden crearse por parte de
2642 procesos creados por procesos hijo de Apache</td></tr>
2643 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>RLimitNPROC <var>number</var>|max [<var>number</var>|max]</code></td></tr>
2644 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>Unset; usa el valor por defecto del sistema operativo</code></td></tr>
2645 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
2646 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>Todas</td></tr>
2647 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2648 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2649 </table>
2650     <p>Toma 1 ó 2 parámetros. El primer parámetro
2651     especifica el límite flexible de recursos para todos los
2652     procesos y el segundo parámetro especifica el límite
2653     máximo de recursos. Cada uno de los parámetros puede ser
2654     un número, ó <code>max</code> para indicarle al servidor que
2655     el límite debe fijarse al máximo permitido por la
2656     configuración del sistema operativo. Para elevar el
2657     límite máximo de recursos es necesario que se esté
2658     ejecutando el servidor como usuario <code>root</code>, o estar en
2659     la fase inicial del arranque.</p>
2660
2661     <p>Esto se aplica a procesos nacidos de la división de
2662     procesos hijo de Apache que están sirviendo peticiones, no a
2663     los procesos hijo de Apache propiamente dichos. Esto incluye a los
2664     scripts CGI y a los comandos de ejecución SSI, pero no a procesos
2665     nacidos de la división del proceso padre Apache tales como
2666     ficheros de registro
2667     redireccionados (piped logs).</p>
2668
2669     <p>Limita el número de procesos por usuario.</p>
2670
2671     <div class="note"><h3>Nota</h3> <p>Si los procesos CGI
2672       <strong>no</strong> están siendo ejecutados por
2673       identificadores de usuario diferentes del identificador de
2674       usuario que está ejecutando el servidor web, esta directiva
2675       limitará el número de procesos que el servidor puede
2676       crear. Como resultado de esta situación, en el
2677       <code>error_log</code> aparecerán mensajes del tipo
2678       <strong><code>cannot fork</code></strong>.</p>
2679     </div>
2680
2681 <h3>Consulte también</h3>
2682 <ul>
2683 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2684 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2685 </ul>
2686 </div>
2687 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2688 <div class="directive-section"><h2><a name="Satisfy" id="Satisfy">Satisfy</a> <a name="satisfy" id="satisfy">Directiva</a></h2>
2689 <table class="directive">
2690 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Interacción entre el control de acceso basado en host
2691 y la autentificación de usuarios</td></tr>
2692 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>Satisfy Any|All</code></td></tr>
2693 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>Satisfy All</code></td></tr>
2694 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>directory, .htaccess</td></tr>
2695 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>AuthConfig</td></tr>
2696 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2697 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2698 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>Influenciada por <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> y <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code> en las versiones de Apache 2.0.51 y
2699 posteriores</td></tr>
2700 </table>
2701     <p>Especifica la política de acceso a seguir cuando se usan tanto
2702     <code class="directive"><a href="../mod/mod_access.html#allow">Allow</a></code> como <code class="directive"><a href="#require">Require</a></code>. El parámetro puede ser
2703     <code>All</code> o <code>Any</code>. Esta directiva es solo útil
2704     si se va restringir el acceso a un área concreta con un nombre de
2705     usuario/contraseña <em>y</em> dirección del cliente. En este caso
2706     el comportamiento por defecto (<code>All</code>) es para requerir
2707     que el cliente pase la restricción referente a la dirección
2708     <em>e</em> introduzca un nombre de usuario y contraseña
2709     válidos. Con la opción <code>Any</code> el cliente podrá acceder
2710     si cumple la restricción referente a la dirección o si introduce un
2711     nombre de usuario y contraseñas válidos. Esto puede usarse para
2712     restringir el acceso a una zona con una contraseña, pero permitir
2713     a los clientes de algunas direcciones en concreto que accedan sin
2714     tener que introducir contraseña alguna.</p>
2715
2716     <p>Por ejemplo, si quiere permitir que todo el mundo tenga acceso
2717     total a su intranet o a una parte de si sitio web, pero requerir que
2718     los visitantes de fuera de su intranet introduzcan una
2719     contraseña, puede usar una configuración similar a la
2720     siguiente:</p>
2721
2722     <div class="example"><p><code>
2723       Require valid-user<br />
2724       Allow from 192.168.1<br />
2725       Satisfy Any
2726     </code></p></div>
2727
2728     <p>A partir de la versión de Apache 2.0.51, puede limitarse
2729     la aplicación de las directivas
2730     <code class="directive">Satisfy</code> a determinados mótodos en
2731     particular mediante secciones <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> y <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>.</p>
2732
2733
2734
2735 <h3>Consulte también</h3>
2736 <ul>
2737 <li><code class="directive"><a href="../mod/mod_access.html#allow">Allow</a></code></li>
2738 <li><code class="directive"><a href="#require">Require</a></code></li>
2739 </ul>
2740 </div>
2741 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2742 <div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a name="scriptinterpretersource" id="scriptinterpretersource">Directiva</a></h2>
2743 <table class="directive">
2744 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Técnica para ubicar el intérprete de scripts CGI's</td></tr>
2745 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
2746 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
2747 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
2748 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
2749 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2750 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2751 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>Solo sistemas Windows; la opció
2752 <code>Registry-Strict</code> está disponible en las versiones de
2753 Apache 2.0 y posteriores</td></tr>
2754 </table>
2755     <p>Esta directiva se usa para controlar la manera que Apache
2756     encuentra el intérprete usado para ejecutar scripts CGI. La
2757     configuración por defecto es <code>Script</code>. Esto hace que
2758     Apache use el intérprete que aparece en la primera línea, la que
2759     empieza por <code>#!</code>) en el script. En los sistemas Win32
2760     esta línea tiene un aspecto similar a:</p>
2761
2762     <div class="example"><p><code>
2763       #!C:/Perl/bin/perl.exe
2764     </code></p></div>
2765
2766     <p>o, si <code>perl</code> está en el <code>PATH</code>,
2767     simplemente:</p>
2768
2769     <div class="example"><p><code>
2770       #!perl
2771     </code></p></div>
2772
2773     <p>Usar <code>ScriptInterpreterSource Registry</code> hará
2774     que se busque en el Registro de Windows, en
2775     <code>HKEY_CLASSES_ROOT</code> con la extensión del fichero
2776     de script (por ejemplo, <code>.pl</code>) como clave de
2777     búsqueda. El comando definido por la subclave del registro de
2778     Windows <code>Shell\ExecCGI\Command</code> o, si esta no existe,
2779     por la subclave <code>Shell\Open\Command</code> se usa para abrir
2780     el script. Si no se encuentra ningún resutlado, Apache
2781     recurre al comportamiento de la opción
2782     <code>Script</code>.</p>
2783
2784     <div class="warning"><h3>Seguridad</h3> <p>Tenga cuidado
2785     cuando use <code>ScriptInterpreterSource Registry</code> con
2786     <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> para
2787     directorios, porque Apache intentará ejecutar
2788     <strong>cada</strong> fichero dentro de ese directorio. Lo
2789     especificado en <code>Registry</code> puede causar llamadas
2790     indeseadas a programas que normalmente no se ejecutan. Por
2791     ejemplo, el programa por defecto para abrir ficheros
2792     <code>.htm</code> en la mayoría de los sistemas Windows es
2793     Microsoft Internet Explorer, entonces cualquier petición HTTP
2794     de un fichero <code>.htm</code> que exista dentro del script del
2795     directorio hará que el ejecute de fondo el navegador en el
2796     servidor. Con esto el servidor se bloqueará en más o
2797     menos un minuto.</p>
2798     </div>
2799
2800     <p>La opción <code>Registry-Strict</code> que es nueva en
2801     Apache 2.0 hace lo mismo que <code>Registry</code> pero usa solo
2802     la subclave <code>Shell\ExecCGI\Command</code>. La clave
2803     <code>ExecCGI</code> no es de uso común. Debe ser configurada
2804     manualmente en el registro de Windows y por tanto previene la
2805     ejecución accidental de procesos en su sistema.</p>
2806
2807 </div>
2808 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2809 <div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a name="serveradmin" id="serveradmin">Directiva</a></h2>
2810 <table class="directive">
2811 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Dirección de email que el servidor incluye en los
2812 mensajes de error que se envían al cliente</td></tr>
2813 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>ServerAdmin <var>email-address</var></code></td></tr>
2814 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
2815 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2816 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2817 </table>
2818     <p><code class="directive">ServerAdmin</code> especifica la dirección de
2819     e-mail que el servidor incluye en cualquier mensaje de error que
2820     envía al cliente.</p>
2821
2822     <p>Sería conveniente tener una dirección de email solo para esto, por ejemplo</p>
2823
2824     <div class="example"><p><code>
2825       ServerAdmin www-admin@foo.example.com
2826     </code></p></div>
2827     <p>ya que los usuarios no siempre mencionan que están hablando
2828     del servidor!</p>
2829
2830 </div>
2831 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2832 <div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a name="serveralias" id="serveralias">Directiva</a></h2>
2833 <table class="directive">
2834 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Nombres alternativos usados para un host cuando se
2835 intentan encontrar equivalencias a hosts virtuales basados en el
2836 nombre</td></tr>
2837 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>ServerAlias <var>hostname</var> [<var>hostname</var>] ...</code></td></tr>
2838 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>virtual host</td></tr>
2839 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2840 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2841 </table>
2842     <p><code class="directive">ServerAlias</code> especifica los nombres
2843     alternativos para un host, para usarlo con <a href="../vhosts/name-based.html">hosts virtuales basados en el
2844     nombre</a>.</p>
2845
2846     <div class="example"><p><code>
2847       &lt;VirtualHost *&gt;<br />
2848       ServerName example.com<br />
2849       ServerAlias example.com server2<br />
2850       # ...<br />
2851       &lt;/VirtualHost&gt;
2852     </code></p></div>
2853
2854 <h3>Consulte también</h3>
2855 <ul>
2856 <li><a href="../vhosts/">Documentación sobre hosting virtual con
2857 Apache</a></li>
2858 </ul>
2859 </div>
2860 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2861 <div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">Directiva</a></h2>
2862 <table class="directive">
2863 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Nombre de host y número de puerto que el servidor usa
2864 para identificarse</td></tr>
2865 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>ServerName <var>fully-qualified-domain-name</var>[:<var>port</var>]</code></td></tr>
2866 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host</td></tr>
2867 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2868 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2869 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>En la versión 2.0, esta directiva sustituye la
2870      funcionalidad de la direciva <code class="directive">Port</code> de la
2871      versión 1.3.</td></tr>
2872 </table>
2873     <p>La directiva <code class="directive">ServerName</code> especifica el
2874     nombre de host y el puerto que usa el servidor para
2875     identificarse. Esto se usa cuando se hace redirección de URLs. Por
2876     ejemplo, si el nombre de la maquina del servidor web es
2877     <code>simple.example.com</code>, pero el la maquina también tiene
2878     el alias DNS <code>www.example.com</code> y quiere que el servidor
2879     web se identifique así, debe usar la siguiente directiva:</p>
2880
2881     <div class="example"><p><code>
2882       ServerName www.example.com:80
2883     </code></p></div>
2884
2885     <p>Si no especifa <code class="directive">ServerName</code>, entonces el
2886     servidor intentará deducir en nombre de host haciendo una
2887     busqueda reversa en la dirección IP. Si no se especifica
2888     ningún puerto en <code class="directive">ServerName</code>, entonces
2889     el servidor usará el puerto para las peticiones
2890     entrantes. Para disfrutar de la máxima fiabilidad y
2891     predictibilidad, debe especificar explicitamente un nombre de host
2892     y un puerto usando la directiva
2893     <code class="directive">ServerName</code>.</p>
2894
2895     <p>Si está usando <a href="../vhosts/name-based.html">hosts
2896     virtuales basados en el nombre</a>, la directiva
2897     <code class="directive">ServerName</code> dentro de una sección <code class="directive"><a href="#virtualhost">&lt;VirtualHost&gt;</a></code> especifica
2898     qué nombre de host debe aparecer en la cabecera de petición
2899     <code>Host:</code> para coincidir con ese host virtual.</p>
2900
2901     <p>Consulte la descripción de la directiva <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> para configuraciones
2902     que determinan si URLs autoreferenciadas (por ejemplo, por el
2903     módulo <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> module) se referirán al puerto
2904     especificado, o al número de puerto dado en la petición del
2905     cliente.
2906     </p>
2907
2908 <h3>Consulte también</h3>
2909 <ul>
2910 <li><a href="../dns-caveats.html">Problemas relacionados en DNS y
2911 Apache</a></li>
2912 <li><a href="../vhosts/">Documentación sobre hosting
2913 virtual</a></li>
2914 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
2915 <li><code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code></li>
2916 <li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li>
2917 </ul>
2918 </div>
2919 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2920 <div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">Directiva</a></h2>
2921 <table class="directive">
2922 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>URL que se usará para hosts virtuales basados en
2923 nombre que son accedidos con un navegador incompatible</td></tr>
2924 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>ServerPath <var>URL-path</var></code></td></tr>
2925 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>virtual host</td></tr>
2926 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2927 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2928 </table>
2929     <p>The <code class="directive">ServerPath</code> directive sets the legacy
2930     URL pathname for a host, for use with <a href="../vhosts/">name-based virtual hosts</a>.</p>
2931
2932 <h3>Consulte también</h3>
2933 <ul>
2934 <li><a href="../vhosts/">Documentación sobre hosting virtual</a></li>
2935 </ul>
2936 </div>
2937 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2938 <div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">Directiva</a></h2>
2939 <table class="directive">
2940 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Directorio base de la instalación del servidor</td></tr>
2941 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>ServerRoot <var>directory-path</var></code></td></tr>
2942 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
2943 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config</td></tr>
2944 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2945 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2946 </table>
2947     <p>La directiva <code class="directive">ServerRoot</code> especifica el
2948     directorio en el que ha sido instalado el servidor. Normalmente
2949     contendrá los subdirectorios <code>conf/</code> y
2950     <code>logs/</code>. Las rutas que se especifican en otras
2951     directivas (por ejemplo en <code class="directive"><a href="#include">Include</a></code> o <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>) se toman como relativas a
2952     este directorio.</p>
2953
2954     <div class="example"><h3>Example</h3><p><code>
2955       ServerRoot /home/httpd
2956     </code></p></div>
2957
2958
2959 <h3>Consulte también</h3>
2960 <ul>
2961 <li><a href="../invoking.html">la opción <code>-d</code> de
2962     <code>httpd</code></a></li>
2963 <li><a href="../misc/security_tips.html#serverroot">consejos se
2964     seguridad</a> para más información de como establecer
2965     adecuadamente los permisos en
2966     <code class="directive">ServerRoot</code></li>
2967 </ul>
2968 </div>
2969 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2970 <div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">Directiva</a></h2>
2971 <table class="directive">
2972 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Configura el pie de página en documentos generados
2973 por el servidor</td></tr>
2974 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
2975 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>ServerSignature Off</code></td></tr>
2976 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
2977 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>All</td></tr>
2978 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
2979 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
2980 </table>
2981     <p>La directiva <code class="directive">ServerSignature</code> permite la
2982     configuración de un pie de página que se
2983     añadirá a documentos generados por el sevidor (mensajes
2984     de error, listado de directorios generados por
2985     <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, salida de
2986     <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>...). La razón por la que puede no
2987     querer añadir este pie de página, es que en una cadena
2988     de proxies, el usuario a menudo no tiene posibilidad de establecer
2989     cual de los servidores encadenados ha retornado un mensaje de
2990     error.</p>
2991
2992     <p>Esta directiva usa por defecto el valor <code>Off</code>, que
2993     suprime la generación del pie de página (y por tanto, es
2994     compatible con el comportamiento de Apache 1.2 y las versiones
2995     anteriores). Si usa el valor <code>On</code> simplemte se
2996     añade una línea con el número de versión y el
2997     valor de <code class="directive"><a href="#servername">ServerName</a></code> para el
2998     host virtual que está respondiendo la petición, y el
2999     valor <code>EMail</code> crea las referencias adicionales
3000     "mailto:" a lo especificado en la directiva <code class="directive"><a href="#serveradmin">ServerAdmin</a></code>.</p>
3001
3002     <p>En las versiones 2.0.44 y posteriores, los detalles del número
3003     de la versión del servidor son controlados por la directiva
3004     <code class="directive"><a href="#servertokens">ServerTokens</a></code>.</p>
3005
3006 <h3>Consulte también</h3>
3007 <ul>
3008 <li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li>
3009 </ul>
3010 </div>
3011 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3012 <div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">Directiva</a></h2>
3013 <table class="directive">
3014 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Configura la cabecera de respuesta HTTP
3015 <code>Server</code></td></tr>
3016 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</code></td></tr>
3017 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>ServerTokens Full</code></td></tr>
3018 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config</td></tr>
3019 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
3020 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
3021 </table>
3022     <p>Esta directiva controla si el campo <code>Server</code> de las
3023     cabeceras de las respuestas que se envían de vuelta a los clientes
3024     incluye una descripción del sistema operativo genérico del
3025     servidor así como información sobre los modulos compilados en el
3026     servidor.</p>
3027
3028     <dl>
3029       <dt><code>ServerTokens Prod[uctOnly]</code></dt>
3030
3031       <dd>El servidor envía (por ejemplo): <code>Server:
3032       Apache</code></dd>
3033
3034       <dt><code>ServerTokens Major</code></dt>
3035
3036       <dd>El servidor envía (por ejemplo): <code>Server:
3037       Apache/2</code></dd>
3038
3039       <dt><code>ServerTokens Minor</code></dt>
3040
3041       <dd>El servidor envía (por ejemplo): <code>Server:
3042       Apache/2.0</code></dd>
3043
3044       <dt><code>ServerTokens Min[imal]</code></dt>
3045
3046       <dd>El servidor envía (por ejemplo): <code>Server:
3047       Apache/2.0.41</code></dd>
3048
3049       <dt><code>ServerTokens OS</code></dt>
3050
3051       <dd>El servidor envía (por ejemplo): <code>Server: Apache/2.0.41
3052       (Unix)</code></dd>
3053
3054       <dt><code>ServerTokens Full</code> (or not specified)</dt>
3055
3056       <dd>El servidor envía (por ejemplo): <code>Server: Apache/2.0.41
3057       (Unix) PHP/4.2.2 MyMod/1.2</code></dd>
3058     </dl>
3059
3060     <p>Esta configuración se aplica al servidor entero, y no puede ser
3061     activada o desactivada para unos hosts virtuales sí y para otros
3062     no.</p>
3063
3064     <p>En las versiones posteriores a la 2.0.44, esta directiva
3065     también controla la información especificada en la directiva
3066     <code class="directive"><a href="#serversignature">ServerSignature</a></code>.</p>
3067
3068 <h3>Consulte también</h3>
3069 <ul>
3070 <li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li>
3071 </ul>
3072 </div>
3073 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3074 <div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">Directiva</a></h2>
3075 <table class="directive">
3076 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Hace que todos los ficheros que correspondan con el valor
3077 especificado sean procesados obligatoriamente por un
3078 handler</td></tr>
3079 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>SetHandler <var>handler-name</var>|None</code></td></tr>
3080 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
3081 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
3082 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
3083 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
3084 <tr><th><a href="directive-dict.html#Compatibility">Compatibilidad:</a></th><td>Trasladado al núcleo del servidor en Apache
3085 2.0</td></tr>
3086 </table>
3087     <p>Cuando se usa en un fichero <code>.htaccess</code> o en una
3088     sección <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> r <code class="directive"><a href="#location">&lt;Location&gt;</a></code>, esta directiva hace que todos
3089     los ficheros cuyo nombre tenga equivalencia con el valor que
3090     especifica sean tratados por el <a href="../handler.html">handler</a> dado en
3091     <var>handler-name</var>. Por ejemplo, si tiene un directorio cuyo
3092     contenido quiere que sea tratado como as fichero de reglas de
3093     mapas de imágenes, independientemente de las extensiones,
3094     puede poner lo siguiente en un fichero <code>.htaccess</code> en
3095     ese directorio:</p>
3096
3097     <div class="example"><p><code>
3098       SetHandler imap-file
3099     </code></p></div>
3100
3101     <p>Otro ejemplo: si quiere que el servidor despliegue un resumen
3102     de su estado cuando se llame a una URL de
3103     <code>http://servername/status</code>, puede poner lo siguiente en
3104     el fichero <code>httpd.conf</code>:</p>
3105
3106     <div class="example"><p><code>
3107       &lt;Location /status&gt;<br />
3108       <span class="indent">
3109         SetHandler server-status<br />
3110       </span>
3111       &lt;/Location&gt;
3112     </code></p></div>
3113
3114     <p>Puede evitar que se aplique lo especificado anteriormente en
3115     una directiva <code class="directive">SetHandler</code> usando el valor
3116     <code>None</code>.</p>
3117
3118 <h3>Consulte también</h3>
3119 <ul>
3120 <li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li>
3121 </ul>
3122 </div>
3123 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3124 <div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">Directiva</a></h2>
3125 <table class="directive">
3126 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Especifica los filtros que procesarán las peticiones de
3127 los clientes y el contenido de peticiones POST</td></tr>
3128 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>SetInputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
3129 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
3130 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
3131 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
3132 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
3133 </table>
3134     <p>La directiva <code class="directive">SetInputFilter</code> espcifica el
3135     filtro o filtros que procesarán las peticiones de los
3136     clientes y el contenido de peticiones POST cuando son recibidas
3137     por el servidor. El filtro o filtros especificados en esta
3138     directiva se aplican además de los definidos en otras partes,
3139     incluyendo los especificados en la directiva <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>.</p>
3140
3141     <p>Si se especifica más de un filtro, deben separarse con puntos y
3142     comas en el orden en que deban procesar los contenidos.</p>
3143
3144 <h3>Consulte también</h3>
3145 <ul>
3146 <li>Documentación sobre <a href="../filter.html">Filtros</a></li>
3147 </ul>
3148 </div>
3149 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3150 <div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">Directiva</a></h2>
3151 <table class="directive">
3152 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Especifica los filtros que procesarán las respuestas del
3153 servidor</td></tr>
3154 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>SetOutputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
3155 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
3156 <tr><th><a href="directive-dict.html#Override">Prevalece sobre:</a></th><td>FileInfo</td></tr>
3157 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
3158 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
3159 </table>
3160     <p>La directiva <code class="directive">SetOutputFilter</code> especifica
3161     los filtros se usarán para procesar las respuestas del servidor
3162     antes de enviarlas al cliente. Esto es además de los filtros
3163     definidos en otras partes, incluidos los de la directiva
3164     <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>.</p>
3165
3166     <p>Por ejemplo, la siguiente configuración procesará todos los
3167     archivos en el directorio <code>/www/data/</code> con server-side
3168     includes.</p>
3169
3170     <div class="example"><p><code>
3171       &lt;Directory /www/data/&gt;<br />
3172       <span class="indent">
3173         SetOutputFilter INCLUDES<br />
3174       </span>
3175       &lt;/Directory&gt;
3176     </code></p></div>
3177
3178     <p>Si se especifica más de un filtro, deben separarse con puntos y
3179     comas en el orden en que deban procesar los contenidos.</p>
3180
3181 <h3>Consulte también</h3>
3182 <ul>
3183 <li>Documentación sobre <a href="../filter.html">Filtros</a></li>
3184 </ul>
3185 </div>
3186 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3187 <div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">Directiva</a></h2>
3188 <table class="directive">
3189 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Cantidad de tiempo que el servidor esperará para que
3190 ocurran determinados eventos antes de cerrar una
3191 petición</td></tr>
3192 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>TimeOut <var>seconds</var></code></td></tr>
3193 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>TimeOut 300</code></td></tr>
3194 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config</td></tr>
3195 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
3196 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
3197 </table>
3198     <p>La directiva <code class="directive">TimeOut</code> define ahora la
3199     cantidad de tiempo que Apache esperará para tres cosas:</p>
3200
3201     <ol>
3202       <li>La cantidad de tiempo que tarda en recibir una
3203       petición GET.</li>
3204
3205       <li>La cantidad de tiempo entre la recepción de paquetes TCP
3206       packets en una petición POST o PUT.</li>
3207
3208       <li>La cantidad de tiempo entre ACKs en transmisiones de
3209       paquetes TCP en las respuestas.</li>
3210     </ol>
3211
3212     <p>Lo planeado es hacer configurable por separado cada una de
3213     estas cosas. La cantidad de tiempo por defecto de 1200 usada antes
3214     de la versión 1.2, ha sido reducida hasta 300, que es en la mayor
3215     parte de las situaciones más de lo necesario. El tiempo usado por
3216     defecto no es menor porque puede que haya alguna parte del código
3217     en que el contador de tiempo no se pone a cero como debería cuando
3218     se envía un paquete. </p>
3219
3220 </div>
3221 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3222 <div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">Directiva</a></h2>
3223 <table class="directive">
3224 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Configura la forma en que el servidor determina su propio
3225 nombre u puerto</td></tr>
3226 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
3227 <tr><th><a href="directive-dict.html#Default">Valor por defecto:</a></th><td><code>UseCanonicalName On</code></td></tr>
3228 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config, virtual host, directory</td></tr>
3229 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
3230 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
3231 </table>
3232     <p>En muchas ocasiones, Apache tiene que construir una URL
3233     <em>autoreferenciada</em> -- esto es, una URL que se refiere de
3234     vuelta al mismo servidor. Con <code>UseCanonicalName On</code>
3235     Apache usará el nombre de host y puerto que estén especificados en
3236     la directiva <code class="directive"><a href="#servername">ServerName</a></code> para
3237     construir el nombre canónico del servidor. Este nombre se usa en
3238     todas las URLs autoreferenciadas, y para los valores de
3239     <code>SERVER_NAME</code> y <code>SERVER_PORT</code> en los
3240     CGIs.</p>
3241
3242     <p>Con <code>UseCanonicalName Off</code> Apache formará las
3243     URLs autoreferenciadas usando el nombre de host y puerto
3244     suministrados por el cliente. Si se ha suministrado esa
3245     información (si no se ha suministrado, se usará el
3246     nombre canónico, tal y como se ha definido arriba). Estos
3247     valores son los mismos que se usan para implementar <a href="../vhosts/name-based.html">hosting virtual basado en
3248     nombres</a>, y están disponibles con los mismos clientes. Las
3249     variables de CGI <code>SERVER_NAME</code> y
3250     <code>SERVER_PORT</code> se construirán con la
3251     información suministrada por los clientes.</p>
3252
3253     <p>Un ejemplo de donde esto puede ser útil es en un servidor de
3254     una intranet, donde los usuarios se conectan a la máquina usando
3255     nombres cortos como <code>www</code>. Se dará cuenta de que si los
3256     usuarios teclean un nombre corto, y una URL que es un directorio,
3257     tal como <code>http://www/splat</code>, <em>sin una barra al
3258     final</em> entonces Apache los rediccionará a
3259     <code>http://www.domain.com/splat/</code>. Si tiene la
3260     autenfificación activada, esto hará que el usuario se tenga que
3261     autentificar dos veces (una para <code>www</code> y otra para
3262     <code>www.domain.com</code> -- consulte <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">las
3263     preguntas más frecuentes sobre este asunto para obtener más
3264     información</a>). Pero si especifica el valor <code>Off</code> en
3265     la directiva <code class="directive">UseCanonicalName</code>, entonces
3266     Apache redireccionará a <code>http://www/splat/</code>.</p>
3267
3268     <p>Hay una tercera opción, <code>UseCanonicalName DNS</code>, para
3269     el caso en que se usa hosting virtual masivo basado en IP para
3270     soportar clientes antiguos que no envían la cabecera
3271     <code>Host:</code>. Con esta opción Apache hace una busqueda de
3272     DNS reversa en la dirección IP del servidor al que el cliente se
3273     conectó para hacer funcionar las URLs autoreferenciadas.</p>
3274
3275     <div class="warning"><h3>Advertencia</h3>
3276
3277     <p>Si los CGIs asumen los valores de <code>SERVER_NAME</code>,
3278     puede que no funcionen con esta opción. El cliente es
3279     esencialmente libre de dar cualquier valor que quiera como nombre
3280     de host. Pero si el CGI solo usa <code>SERVER_NAME</code> para
3281     constrir URLs autoreferenciadas, entonces no debe haber ningún
3282     problema.</p>
3283     </div>
3284
3285 <h3>Consulte también</h3>
3286 <ul>
3287 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
3288 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
3289 </ul>
3290 </div>
3291 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3292 <div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost">&lt;VirtualHost&gt;</a> <a name="virtualhost" id="virtualhost">Directiva</a></h2>
3293 <table class="directive">
3294 <tr><th><a href="directive-dict.html#Description">Descripción:</a></th><td>Contiene las directivas que se aplican solo a un nombre
3295 de host específico o dirección IP</td></tr>
3296 <tr><th><a href="directive-dict.html#Syntax">Sintaxis:</a></th><td><code>&lt;VirtualHost
3297     <var>addr</var>[:<var>port</var>] [<var>addr</var>[:<var>port</var>]]
3298     ...&gt; ... &lt;/VirtualHost&gt;</code></td></tr>
3299 <tr><th><a href="directive-dict.html#Context">Contexto:</a></th><td>server config</td></tr>
3300 <tr><th><a href="directive-dict.html#Status">Estado:</a></th><td>Core</td></tr>
3301 <tr><th><a href="directive-dict.html#Module">Módulo:</a></th><td>core</td></tr>
3302 </table>
3303     <p><code class="directive">&lt;VirtualHost&gt;</code> y
3304     <code>&lt;/VirtualHost&gt;</code> se usan para incluir un grupo de
3305     directivas que se aplicarán solo a un host virtual en
3306     particular. Cualquier directiva que esté permitido usar en un
3307     contexto virtual host puede usarse. Cuando el servidor recibe una
3308     petición de un documento de un host virtual en concreto, usa las
3309     directivas de configuración incluidas en la sección <code class="directive">&lt;VirtualHost&gt;</code>. <var>Addr</var> puede
3310     ser:</p>
3311
3312     <ul>
3313       <li>La dirección IP del host virtual;</li>
3314
3315       <li>Un nombre de dominio completo para la dirección IP del host
3316       virtual;</li>
3317
3318       <li>El carácter <code>*</code>, el cual puede usarse en
3319       combinación con <code>NameVirtualHost *</code> para que
3320       equivalga a todas las direcciones IP; o</li>
3321
3322       <li>La cadena de caracteres <code>_default_</code>, que se usa
3323       solo con hosting virtual IP para detectar direcciones IP sin
3324       emparejar.</li>
3325     </ul>
3326
3327     <div class="example"><h3>Ejemplo</h3><p><code>
3328       &lt;VirtualHost 10.1.2.3&gt;<br />
3329       <span class="indent">
3330         ServerAdmin webmaster@host.foo.com<br />
3331         DocumentRoot /www/docs/host.foo.com<br />
3332         ServerName host.foo.com<br />
3333         ErrorLog logs/host.foo.com-error_log<br />
3334         TransferLog logs/host.foo.com-access_log<br />
3335       </span>
3336       &lt;/VirtualHost&gt;
3337     </code></p></div>
3338
3339
3340     <p>Las direcciones IPv6 deben especificarse entre corchetes porque
3341     el número de puerto opcional no podría determinarse si no se hace
3342     así. Un ejemplo de dirección IPv6 se mustra aquí abajo:</p>
3343
3344     <div class="example"><p><code>
3345       &lt;VirtualHost [2001:db8::a00:20ff:fea7:ccea]&gt;<br />
3346       <span class="indent">
3347         ServerAdmin webmaster@host.example.com<br />
3348         DocumentRoot /www/docs/host.example.com<br />
3349         ServerName host.example.com<br />
3350         ErrorLog logs/host.example.com-error_log<br />
3351         TransferLog logs/host.example.com-access_log<br />
3352       </span>
3353       &lt;/VirtualHost&gt;
3354     </code></p></div>
3355
3356     <p>Cada host virtual se corresponde con una dirección IP
3357     diferente, un número de puerto diferente o un nombre de host
3358     diferente para el servidor, en el primer caso la máquina del
3359     servidor debe estar configurada para aceptar paquetes IP para
3360     múltiples direcciones. (Si la máquina no tiene múltiples infaces
3361     de red, entonces esto puede conseguirse con el comando
3362     <code>ifconfig alias</code> -- si su sistema operativo lo
3363     soporta).</p>
3364
3365     <div class="note"><h3>Nota</h3> <p>El uso de <code class="directive">&lt;VirtualHost&gt;</code> <strong>no</strong> afecta
3366     a las direcciones en las que escucha Apache. Puede que necesite
3367     asegurarse de que Apache está escuchando en la dirección correcta
3368     usando <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p>
3369     </div>
3370
3371     <p>Cuando se usa hosting virtual basado en IP, puede
3372     especificarse el nombre especial <code>_default_</code>, en cuyo
3373     caso, este host virtual equivaldrá a cualquier dirección IP que no
3374     esté especificamente listada en otro host virtual. En ausencia de
3375     un host virtual <code>_default_</code> el server config
3376     "principal", consistente en todas las definiciones fuera de una
3377     sección VirtualHost, se usa cuando la IP no coincide con ninguna.
3378     (Pero tenga en cuenta que cualquier dirección IP que equivalga a
3379     la directiva <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code>
3380     no usará ni el server config "principal" ni el host virtual
3381     <code>_default_</code> virtual host.  Consulte la documentación de
3382     <a href="../vhosts/name-based.html">hosting virtual basado en
3383     nombres</a> para obtener más información.)</p>
3384
3385     <p>Puede especificar <code>:port</code> para cambiar el puerto
3386     de equivalencia. Si no especifica ninguno, entonces por defecto se
3387     usa el mismo puerto de la directiva <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> mas reciente del servidor
3388     principal. También puede especificar <code>:*</code> para hacer
3389     coincidir con todos los puertos en esa dirección. (Esto se
3390     recomienda cuando se usa con <code>_default_</code>.)</p>
3391
3392     <div class="warning"><h3>Seguridad</h3>
3393     <p>Consulte la documentación de <a href="../misc/security_tips.html">consejos de seguridad</a> para
3394     obtener más información sobre por qué pone en riesgo la seguridad
3395     si en el directorio donde almacena los archivos log tiene permisos
3396     de escritura alguien que no sea el usuario que inicia el
3397     servidor.</p>
3398     </div>
3399
3400 <h3>Consulte también</h3>
3401 <ul>
3402 <li><a href="../vhosts/">Documentación sobre hosting virtual</a></li>
3403 <li><a href="../dns-caveats.html">Problemas relacionados con DNS y Apache</a></li>
3404 <li><a href="../bind.html">Especificar las direcciones y puertos que usa Apache</a></li>
3405 <li><a href="../sections.html">Cómo funcionan las secciones
3406     &lt;Directory&gt;, &lt;Location&gt; y &lt;Files&gt;</a> si quiere
3407     una explicación completa de como se combinan esas secciones cuando
3408     se recibe una petición</li>
3409 </ul>
3410 </div>
3411 </div>
3412 <div class="bottomlang">
3413 <p><span>Idiomas disponibles: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
3414 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
3415 <a href="../es/mod/core.html" title="Español">&nbsp;es&nbsp;</a> |
3416 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
3417 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
3418 </div><div id="footer">
3419 <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>
3420 <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>
3421 </body></html>