Términos Usados para Describir Directivas de Apache

Cada directiva de configuración de Apache es descrita usando un formato común que se asemeja a éste:

Sintaxis: nombre-directiva algunos argumentos
Por Defecto: nombre-directiva valor-por-defecto
Contexto: lista-contexto
Invalida: invalidación
Estado: estado
Módulo: nombre-módulo
Compatibilidad: notas de compatibilidad

Cada uno de los atributos de directiva, junto con los posibles valores válidos, son descritos en este documento.

Términos de Directiva


Sintaxis

Indica el formato de la directiva tal y como debería aparecer en un fichero de configuración. Esta sintaxis es extremadamente específica de la directiva, y es descrita con detalle en la definición de la directiva. Generalmente, el nombre de la directiva es seguido por una serie de uno o más argumentos. Los argumentos opcionales son encerrados entre corchetes. Cuando un argumento puede tomar más de un posible valor, los posibles valores están separados por una barra vertical. El texto literal se presenta en la fuente por defecto, mientras que los tipos de los argumentos para los cuales es necesaria la sustitución son enfatizados. Las directivas que pueden tomar un número variable de argumentos deberán terminar en "..." indicando así que el último argumento se repite.


Por Defecto

Si la directiva tiene un valor por defecto (i.e., si la omite por completo de su configuración, el servidor Web Apache deberá proceder como si se hubiera establecido un valor particular), éste es descrito aquí. Si no tiene valor por defecto, esta sección debería decir "Ninguno".


Contexto

Indica en qué parte del fichero de configuración del servidor la directiva es legal. Se trata de una lista separada por comas de uno o más de los siguientes valores:

configuración del servidor
Significa que la directiva puede ser usada en los ficheros de configuración del servidor (v.g., httpd.conf, srm.conf, y access.conf), pero no entre algún contenedor <VirtualHost> o <Directory>. No está permitida en ficheros .htaccess de ninguna manera.

host virtual
Este contexto significa que la directiva puede aparecer dentro del contenedor <VirtualHost> en los ficheros de configuración del servidor.

directorio
Una directiva marcada como válida en este contexto puede ser usada dentro de contenedores <Directory>, <Location>, y <Files> en los ficheros de configuración del servidor, sometida a las restricciones recogidas en Cómo funcionan las secciones Directory, Location y Files.

.htaccess
Si una directiva es válida en este contexto, significa que puede aparecer en los ficheros .htaccess de cada directorio. Puede no ser procesada, dependiendo de las invalidaciones actualmente activas.

La directiva sólo está permitida en el contexto designado; si usted trata de usarla de todos modos, obtendrá un error de configuración que o bien impedirá al servidor manejar correctamente las peticiones en este contexto, o bien impedirá el funcionamiento del servidor -- i.e., el servidor ni siquiera arrancaría.

Las localizaciones válidas para la directiva es actualmente el resultado de un OR Booleano de todos los contextos listados. En otras palabras, una directiva que es señalada como válida en "server config, .htaccess" puede ser usada en el fichero httpd.conf y en los ficheros .htaccess, pero no entre algún contenedor <Directory> o <VirtualHost>.


Invalida

Este atributo de directiva indica qué invalidación de configuración debe activarse para que la directiva pueda ser procesada cuando aparezca en un fichero .htaccess. Si el contexto de la directiva no le permite aparecer en ficheros .htaccess, este atributo debe decir "No aplicable".

Las invalidaciones son activada por la directiva AllowOverride , y se aplica a un campo de acción particular (como a un directorio) y a todos sus descendientes, mientras no sea modificado por otras directivas AllowOverride en niveles inferiores. La documentación para esta directiva también lista los nombres de posibles invalidaciones disponibles.


Estado

Indica lo fuertemente ligada que está la directiva al servidor Apache; en otras palabras, puede necesitar recompilar el servidor con un conjunto ampliado de módulos para conseguir el acceso a la directiva y a su funcionalidad. Los posibles valores para este atributo son:

Núcleo
Si una directiva aparece teniendo un estado "Núcleo", significa que forma parte de la porción más interna del servidor Web Apache, y siempre está disponible.

Base
Una directiva etiquetada teniendo un estado "Base" es soportada por uno de los módulos estándar de Apache que es compilado por defecto en el servidor, y por lo tanto está disponible normalmente mientras no haya realizado los pasos para eliminar el módulo de su configuración.

Extensión
Una directiva con estado "Extensión" es proporcionada por uno de los módulos incluidos con el paquete del servidor Apache, pero el módulo normalmente no es compilado en el servidor. Para habilitar la directiva y su funcionalidad, puede necesitar cambiar los ficheros de configuración para la construcción del servidor y re-compilar Apache.

Experimental
Estado "Experimental" indica que la directiva está disponible como parte del paquete de Apache, pero queda bajo su responsabilidad el usarla. La directiva está documentada en un intento de exahustividad, pero no está necesariamente soportada. El módulo que proporciona la directiva puede o no puede estar compilado por defecto; compruebe el principio de la página que describe la directiva y su módulo para ver si se señala la disponibilidad.


Módulo

Sencillamente lista el nombre del módulo fuente dónde se define la directiva.


Compatibilidad

Si la directiva no forma parte de la distribución original de Apache versión 1, la versión en la que ha sido introducida debe aparecer aquí. Si la directiva tiene el mismo nombre que una del servidor HTTPd NCSA, cualquier inconsistencia en el comportamiento entre ambas también debe ser mencionada. En otro caso, este atributo debe decir "No presenta problemas de compatibilidad."