Términos que se Usan para Describir Directivas

Descripción ¶

Una breve descripción del propósito de la directiva.

Sintaxis ¶

Indica el formato de la directiva tal y como aparecería en un fichero de configuración. Esta sintaxis es muy específica de cada directiva, y se describe con detalle en la definición de la directiva. Generalmente, el nombre de la directiva va seguido de una serie de uno o más parámetros separados por un espacio. Si un parámetro contiene un espacio, éste debe especificarse entre comillas dobles. Los parámetros opcionales van especificados entre corchetes. Donde un parámetro puede tener uno o más valores, los valores posibles se separan con barras verticales "|". El Texto Literal se muestra con la fuente por defecto, mientras que los distintos tipos de parámetros para los que una sustitución resulta necesaria son enfatizados. Las directivas que pueden tomar una lista variada de parámetros acaban en "..." indicando que el último parámetro se repite.

Las Directivas usan un gran número de diferentes tipos de parámetros. A continuación definimos algunos de los más comunes.

URL

Un Localizador de Recursos Uniforme, incluye un esquema, nombre de host, y un path opcional como en http://www.example.com/path/to/file.html

Ruta de URL

La parte de una url que sigue al esquema y el nombre de host como en http://www.example.com/path/to/file.html. El url-path representa una vista-web de un recurso, en contraposición a una vista de sistema-de-ficheros.

Ruta del Fichero

La ruta a un fichero en el sistema de ficheros local que comienza desde el directorio raíz como en /usr/local/apache/htdocs/path/to/file.html. A menos que se especifique, una ruta de fichero que no comienza con una barra "/" se tratará como una ruta relativa a ServerRoot.

Ruta del Directorio

La ruta a un directorio en el sistema de ficheros local que comienza con el directorio raíz como en /usr/local/apache/htdocs/path/to/.

Nombre del Fichero

El nombre de un fichero sin ir acompañado de información de la ruta como en file.html.

regex

Una expresión regular compatible con Perl. La definición de directiva especificará contra qué se compara la regex.

extensión

En general, esta es la parte del nombre de fichero que sigue al último punto. Sin embargo, Apache reconoce múltiples extensiones de fichero, así que si un nombre de fichero contiene más de un punto, cada parte separada por un punto del nombre de fichero después del primer punto es una extensión. Por ejemplo, el nombre de fichero file.html.en contiene dos extensiones: .html y .en. Para las directivas de Apache, podrá especificar la extensiones con o sin el punto inicial. Además, las extensiones no son sensibles a mayúsculas o minúsculas.

Tipo MIME

Un método de describir el formato de un fichero que está formado por un tipo de formato mayor y un tipo de formato menor, separados de de una barra como en text/html.

Variable de Entorno

El nombre de una variable de entorno definida en el proceso de configuración de Apache. Tenga en cuenta que esto no es necesariamente lo mismo que la variable de entorno de un sistema operativo. Vea la documentación de variable de entorno para más detalles.

Por defecto ¶

Si la directiva tiene un valor por defecto (p.ej., si la omite de la configuración completamente, el servidor Web Apache se comportará como si la hubiera configurado con un valor en particular), se describe aquí. Si no tiene valor por defecto, esta sección debería indicar "Ninguno". Tenga en cuenta que el valor por defecto listado aquí no es necesariamente el mismo que el valor que toma la directiva en el httpd.conf por defecto distribuido con el servidor.

Contexto ¶

Esto indica dónde se acepta la directiva en los ficheros de configuración. Es una lista separada por comas para uno o más de los siguientes valores:

server config

Esto indica que la directiva puede usarse en los ficheros de configuración del servidor (p.ej., httpd.conf), pero not dentro de cualquier contenedor <VirtualHost> o <Directory>. No se permite en ficheros .htaccess de ninguna manera.

virtual host

Este contexto significa que la directiva puede aparecer dentro de un contenedor <VirtualHost> en el fichero de configuración del servidor.

directory

Una directiva marcada como válida en este contexto puede usarse dentro de contenedores <Directory>, <Location>, <Files>, <If>, <Proxy> en los ficheros de configuración del servidor, sujeta a las restricciones destacadas en las Secciones de Configuración.

.htaccess

Si una directiva es válida en este contexto, significa que puede aparecer dentro de ficheros .htaccess por directorio. Aunque podría no ser procesada, dependiendo de si la configuración de AllowOverride está activa en ese momento.

La directiva sólo se permite dentro del contexto designado; si intenta usarlo en algún otro, obtendrá un error de configuración que impedirá que el servidor gestione correctamente las solicitudes en ese contexto, o impedirá que el servidor pueda funcionar completamente -- p.ej., el servidor no arrancará.

Las ubicaciones válidas para la directiva son actualmente el resultado de una función buleana OR de todos los contextos listados. En otras palabras, una directiva que está marcada como válida en "server config, .htaccess" puede usarse en el fichero httpd.conf y en ficheros .htaccess, pero no dentro de contenedores <Directory> o <VirtualHost>.

Override ¶

Este atributo de directiva indica qué Override de configuración debe estar activo para que la directiva se procese cuando aparece en un fichero .htaccess. Si el contexto de la directiva no permite que aparezca en ficheros .htaccess, entonces no se listará ningún contexto.

Los Override o sobreescritura se activan con la directiva AllowOverride, si se aplican a un ámbito en particular (como por ejemplo un directorio) y todos sus descendientes, a menos que se modifique más adelante por otras directivas AllowOverride en niveles inferiores. La documentación para la directiva también muestra una lista de los posibles nombres de Override disponibles.

Estado ¶

Esto indica cuan vinculada está esta directiva al servidor Web de Apache; o en otras palabras, puede que necesite recompilar el servidor con un conjunto mejor de módulos para obtener acceso a esta directiva y su funcionalidad. Valores posibles para estar directiva son:

Core

Si una directiva aparece listada con estado "Core", eso significa que forma parte de las partes más internas del Servidor Apache Web, y que siempre está disponible.

MPM

La directivas facilitadas por un Módulo de Multi-Proceso están etiquetadas con Estado "MPM". Este tipo de directiva estará disponible si y sólo si está usando uno de los MPM listados en la línea Módulo de la definición de la directiva.

Base

Una directiva listada con estado "Base" está facilitada por uno de los módulos estándar de Apache que están compilados con el servidor por defecto, y por tanto está normalmente disponible a menos que usted haga las acciones necesarias para eliminar este módulo de su configuración.

Extensión

Una directiva con estado "Extensión" está facilitada por uno de los módulos incluidos en el kit del servidor Apache, pero el módulo no está compilado generalmente dentro del servidor. Para activar esta y su funcionalidad, necesitará cambiar la configuración de compilación del servidor y recompilar Apache.

Experimental

El estado "Experimental" indica que la directiva está disponible como parte del kit de Apache, pero usted tendrá que ir por su cuenta si intenta usarla. La directiva se documenta para aportar información, pero no tiene por qué estar soportada de manera oficial. El módulo que provee esta directiva puede o puede que no esté compilado por defecto, compruebe la parte superior de la página que describe la directiva y el módulo para ver las anotaciones sobre su disponibilidad.

Módulo ¶

Ésto simplemente hace referencia al nombre del módulo original que provee la directiva.

Compatibilidad ¶

Si la directiva no era parte de la distribución original de Apache versión 2, la versión en la que se introdujo debería estar referida aquí. Además, si la directiva solo está disponible en ciertas plataformas, se verá anotado aquí.