Descripción: Generación de Expires y Cache-Control Encabezados HTTP de acuerdo con los criterios especificados por el usuario
Estado: Extensión
ModuleIdentifier: expires_module
Archivo fuente: mod_expires.c

Resumen

Este módulo controla la configuración del Expires Encabezado HTTP y el max-age directiva de la Cache-Control Encabezado HTTP en las respuestas del servidor. La fecha de vencimiento se puede establecer para que sea relativa a la hora en que se modificó por última vez el archivo de origen o al momento del acceso del cliente.

Estos encabezados HTTP son una instrucción para el cliente sobre la validez y persistencia del documento. Si se almacena en caché, el documento se puede recuperar de la caché en lugar de la fuente hasta que haya pasado este tiempo. Después de eso, la copia de la caché se considera “caducada” y no válida, y se debe obtener una nueva copia de la fuente.

Modificar Cache-Control directivas distintas de max-age (ver RFC 2616 sección 14.9), puede utilizar el Header directiva.

Cuando el Expires El encabezado ya es parte de la respuesta generada por el servidor, por ejemplo, cuando se genera mediante un script CGI o se envía desde un servidor de origen, este módulo no cambia ni agrega un Expires o Cache-Control encabezamiento.

Sintaxis de intervalo alternativo

El ExpiresDefault y ExpiresByType Las directivas también se pueden definir en una sintaxis más legible de la forma:

ExpiresDefault "base  [plus numtype] [numtype] ..."
ExpiresByType type/encoding "base  [plus numtype] [numtype] ..."

donde base es uno de:

  • access
  • now (equivalente a ‘access‘)
  • modification

El plus la palabra clave es opcional. num debe ser un valor entero [acceptable to atoi()], y escribe es uno de:

  • years
  • months
  • weeks
  • days
  • hours
  • minutes
  • seconds

Por ejemplo, cualquiera de las siguientes directivas se puede utilizar para hacer que los documentos caduquen 1 mes después de haberlos accedido, de forma predeterminada:

ExpiresDefault "access plus 1 month"
ExpiresDefault "access plus 4 weeks"
ExpiresDefault "access plus 30 days"

El tiempo de caducidad se puede ajustar agregando varios ‘numescribe‘cláusulas:

ExpiresByType text/html "access plus 1 month 15 days 2 hours"
ExpiresByType image/gif "modification plus 5 hours 3 minutes"

Tenga en cuenta que si utiliza una configuración basada en la fecha de modificación, el encabezado Expires no agregarse a contenido que no provenga de un archivo en el disco. Esto se debe al hecho de que no existe un tiempo de modificación para dicho contenido.

Caduca Directiva activa

Descripción: Permite la generación de Expires encabezados
Sintaxis: 
ExpiresActive On|Off
Defecto: 
ExpiresActive Off
Contexto: configuración del servidor, host virtual, directorio, .htaccess
Anular: Índices
Estado: Extensión
Módulo: mod_expires

Esta directiva habilita o deshabilita la generación de Expires y Cache-Control encabezados para el dominio del documento en cuestión. (Es decir, si se encuentra en un .htaccess archivo, por ejemplo, se aplica sólo a los documentos generados a partir de ese directorio.) Si se establece en Off, los encabezados no se generarán para ningún documento en el reino (a menos que se anulen en un nivel inferior, como un .htaccess archivo que anula un archivo de configuración del servidor). Si se establece en On, los encabezados se agregarán a los documentos servidos de acuerdo con los criterios definidos por el ExpiresByType y ExpiresDefault directivasqv).

Tenga en cuenta que esta directiva no garantiza que un Expires o Cache-Control Se generará el encabezado. Si no se cumplen los criterios, no se enviará ningún encabezado y el efecto será como si esta directiva ni siquiera se hubiera especificado.

Directiva ExpiresByType

Descripción: Valor de la Expires encabezado configurado por tipo MIME
Sintaxis: 
ExpiresByType tipo MIME seconds
Context: server config, virtual host, directory, .htaccess
Override: Indexes
Status: Extension
Module: mod_expires

This directive defines the value of the Expires encabezado y el max-age directiva de la Cache-Control encabezado generado para documentos del tipo especificado (p.ej, text/html). El segundo argumento establece la cantidad de segundos que se agregarán a un tiempo base para construir la fecha de vencimiento. El Cache-Control: max-age se calcula restando el tiempo de solicitud de la fecha de vencimiento y expresando el resultado en segundos.

La hora base es la hora de la última modificación del archivo o la hora del acceso del cliente al documento. Cuál debe ser utilizado está especificado por el campo; M significa que la hora de la última modificación del archivo debe usarse como hora base, y A significa que se debe utilizar el tiempo de acceso del cliente.

La diferencia de efecto es sutil. Si M se utiliza, todas las copias actuales del documento en todas las cachés caducarán al mismo tiempo, lo que puede ser bueno para algo así como un aviso semanal que siempre se encuentra en la misma URL. Si A se utiliza, la fecha de vencimiento es diferente para cada cliente; esto puede ser bueno para archivos de imagen que no cambian con mucha frecuencia, particularmente para un conjunto de documentos relacionados que hacen referencia a las mismas imágenes (es decir, se accederá a las imágenes repetidamente en un período de tiempo relativamente corto).

Ejemplo:

# enable expirations
ExpiresActive On
# expire GIF images after a month in the client's cache
ExpiresByType image/gif A2592000
# HTML documents are good for a week from the
# time they were changed
ExpiresByType text/html M604800

Tenga en cuenta que esta directiva solo tiene efecto si ExpiresActive On ha sido especificado. Anula, para el tipo MIME especificado solo, cualquier fecha de vencimiento establecida por el ExpiresDefault directiva.

También puede especificar el cálculo del tiempo de vencimiento utilizando una sintaxis alternativa, descrita anteriormente en este documento.

Caduca la directiva predeterminada

Descripción: Algoritmo predeterminado para calcular el tiempo de caducidad
Sintaxis: 
Caduca por defecto seconds
Context: server config, virtual host, directory, .htaccess
Override: Indexes
Status: Extension
Module: mod_expires

This directive sets the default algorithm for calculating the expiration time for all documents in the affected realm. It can be overridden on a type-by-type basis by the ExpiresByType directiva. Consulte la descripción de esa directiva para obtener detalles sobre la sintaxis del argumento y también la descripción de la sintaxis alternativa.