<-
Apache > HTTP Server > Documentation > Version 2.0 > Modules

Apache Модуль mod_cache

Description: довольный тайник работал ключом к URIs.
Status: экспериментальный
Module Identifier: cache_module
Source File: mod_cache.c

резюме

этот модуль экспериментален. Документация находится все еще под развитием...

mod_cache орудия RFC 2616 послушные HTTP удовлетворяют тайник, который может использоваться, чтобы припрятать про запас или местный или содержание proxied. mod_cache требует услуг одного или более модулей управления хранения. Два модуля управления хранения включены в основное Apacheское распределение:

mod_disk_cache
осуществляет диск, базируемый менеджер хранения.
mod_mem_cache
осуществляет память, базируемую менеджер хранения. mod_mem_cache может формироваться, чтобы работать в двух способах: кэширование открытых описателей файла или кэширования объектов в хранении кучи. mod_mem_cache может использоваться, чтобы припрятать про запас в местном масштабе произведенное содержание или припрятать содержание сервера конца про запас для mod_proxy когда формируется используя ProxyPass (иначе обратное полномочие )

содержание сохранено в и восстановлено от тайника, используя базируемые ключи ТУРОВ. Содержание с защитой доступа не прячется про запас.

директивы

темы

top

Related Modules and Directives

top

Sample Configuration

Sample httpd.conf

#
# Sample Cache Configuration
#
LoadModule cache_module modules/mod_cache.so

<IfModule mod_cache.c>
#LoadModule disk_cache_module modules/mod_disk_cache.so
<IfModule mod_disk_cache.c>
CacheRoot c:/cacheroot
CacheSize 256
CacheEnable disk /
CacheDirLevels 5
CacheDirLength 3
</IfModule>

LoadModule mem_cache_module modules/mod_mem_cache.so
<IfModule mod_mem_cache.c>
CacheEnable mem /
MCacheSize 4096
MCacheMaxObjectCount 100
MCacheMinObjectSize 1
MCacheMaxObjectSize 2048
</IfModule>
</IfModule>

top

CacheDefaultExpire Directive

Description: продолжительность по умолчанию, чтобы припрятать документ про запас, когда никакая дата окончания срока действия не определена.
Syntax: CacheDefaultExpire seconds
Default: CacheDefaultExpire 3600 (one hour)
Context: сервер config, действительный хозяин
Status: экспериментальный
Module: mod_cache

CacheDefaultExpire директива определяет время по умолчанию, в секундах, припрятать документ про запас, если ни дата окончания срока действия, ни последнее-измененная дата не предоставляются документ. Ценность, определенная с CacheMaxExpire директива делает нет отвергнуть это урегулирование.

CacheDefaultExpire 86400

top

CacheDisable Directive

Description: повредить кэширование указанных URL
Syntax: CacheDisable url-string
Context: сервер config, действительный хозяин
Status: экспериментальный
Module: mod_cache

CacheDisable директива инструктирует mod_cache к нет URL тайника в или ниже вереница URL .

Example

CacheDisable /local_files

top

CacheEnable Directive

Description: позволить кэширование указанных URL, используя указанного менеджера хранения
Syntax: CacheEnable cache_type url-string
Context: сервер config, действительный хозяин
Status: экспериментальный
Module: mod_cache

CacheEnable директива инструктирует mod_cache припрятать URL про запас в или ниже вереница URL . менеджер хранения тайника определен с cache_type аргумент. cache_type mem инструктирует mod_cache использовать память базировало менеджера хранения, осуществленного mod_mem_cache . cache_type disk инструктирует mod_cache использовать диск базировало менеджера хранения, осуществленного mod_disk_cache . cache_type fd инструктирует mod_cache использовать тайник описателя файла, осуществленный mod_mem_cache .

когда место URL накладывается между различным CacheEnable директивы (как в примере ниже), каждым возможным менеджером хранения будут управлять до первого, который фактически обрабатывает запрос. Заказ, в котором управляют менеджерами хранения, определен по приказу CacheEnable директивы в файле конфигурации.

CacheEnable mem /manual
CacheEnable fd /images
CacheEnable disk /

top

CacheForceCompletion Directive

Description: процент от документа служил, после которого сервер закончит кэширование файла, даже если запрос будет отменен.
Syntax: CacheForceCompletion Percentage
Default: CacheForceCompletion 60
Context: сервер config, действительный хозяин
Status: экспериментальный
Module: mod_cache

обычно, если запрос будет отменен, в то время как ответ прячется про запас и поставляется клиенту, то обработка ответа остановится, и вход тайника будет удален. CacheForceCompletion директива определяет порог, вне которого документ продолжит прятаться про запас к завершению, даже если запрос будет отменен.

порог - процент, определенный как ценность между 1 и 100 . ценность 0 определяет, что неплатеж используется. Ценность 100 только припрячет документы про запас, которым служат в их полноте. Ценность между 60 и 90 рекомендуется.

CacheForceCompletion 80

отметить:

эта особенность - в настоящее время нет осуществленный.
top

CacheIgnoreCacheControl Directive

Description: игнорировать факт, что клиент просил содержание не прятаться про запас.
Syntax: CacheIgnoreCacheControl On|Off
Default: CacheIgnoreCacheControl Off
Context: сервер config, действительный хозяин
Status: экспериментальный
Module: mod_cache

обычно, документы с ценностями удара головой без склада или без тайника не будут сохранены в тайнике. CacheIgnoreCacheControl директива позволяет этому поведению быть отвергнутым. CacheIgnoreCacheControl на говорит серверу пытаться припрятать документ про запас, даже если это содержит ценности удара головой без склада или без тайника. Документы, требующие разрешения будут никогда прятаться про запас.

CacheIgnoreCacheControl On

top

CacheIgnoreHeaders Directive

Description: не хранить данный удар (ы) головой HTTP в тайнике.
Syntax: CacheIgnoreHeaders header-string [ header-string ] ...
Default: CacheIgnoreHeaders None
Context: сервер config, действительный хозяин
Status: экспериментальный
Module: mod_cache

согласно RFC 2616, перелет-перелетом удары головой HTTP не сохранены в тайнике. Следующие удары головой HTTP - удары головой перелета-перелетом и таким образом не становятся сохраненными в тайнике в любой случай независимо от урегулирования CacheIgnoreHeaders :

CacheIgnoreHeaders определяет дополнительные удары головой HTTP, которые не должны, чтобы быть сохраненными в тайнике. Например, это имеет смысл в некоторых случаях препятствовать печенью быть сохраненным в тайнике.

CacheIgnoreHeaders берет отделенный список места ударов головой HTTP, которые не должны быть сохранены в тайнике. Если только удары головой перелета-перелетом не должны быть сохранены в тайнике (RFC 2616 послушных поведений), CacheIgnoreHeaders может собираться None .

Example 1

CacheIgnoreHeaders Set-Cookie

Example 2

CacheIgnoreHeaders None

предупреждение:

если удары головой как Expires которые необходимы для надлежащего управления тайника, не сохранены из-за a CacheIgnoreHeaders урегулирование, поведение mod_cache неопределено.
top

CacheIgnoreNoLastMod Directive

Description: игнорировать факт, что ответ имеет никакой Последний Измененный удар головой.
Syntax: CacheIgnoreNoLastMod On|Off
Default: CacheIgnoreNoLastMod Off
Context: сервер config, действительный хозяин
Status: экспериментальный
Module: mod_cache

обычно, документы без последнее-измененной даты не прячутся про запас. При некоторых обстоятельствах удалена последнее-измененная дата (в течение mod_include обработка например) или не обеспеченный вообще. CacheIgnoreNoLastMod директива обеспечивает способ определить, что документы без последнее-измененных дат нужно рассмотреть для кэширования, даже без последнее-измененной даты. Если ни последнее-измененной дате, ни дате окончания срока действия не предоставляют документ тогда ценность, определенная CacheDefaultExpire директива будет использоваться, чтобы произвести срок годности.

CacheIgnoreNoLastMod On

top

CacheLastModifiedFactor Directive

Description: фактор имел обыкновение вычислять дату окончания срока действия, основанную в дату LastModified.
Syntax: CacheLastModifiedFactor float
Default: CacheLastModifiedFactor 0.1
Context: сервер config, действительный хозяин
Status: экспериментальный
Module: mod_cache

когда документ не обеспечивает дату окончания срока действия, но действительно обеспечивает последнее-измененную дату, дата окончания срока действия может быть вычислена основанная на времени, так как документ был последний измененный. CacheLastModifiedFactor директива определяет a фактор использоваться в поколении этой даты окончания срока действия согласно следующей формуле: expiry-period = time-since-last-modified-date * factor expiry-date = current-date + expiry-period например, если документ был прошлые измененные 10 часов назад, и фактор является 0.1 тогда, период истечения будет собираться 10*0.1 = 1 час. Если бы текущее время было 3:00pm тогда, то вычисленная дата окончания срока действия была бы 3:00pm + 1hour = 4:00pm. Если период истечения был бы более длинным чем тот набор CacheMaxExpire , тогда последний имеет приоритет.

CacheLastModifiedFactor 0.5

top

CacheMaxExpire Directive

Description: максимальное время в секундах, чтобы припрятать документ про запас
Syntax: CacheMaxExpire seconds
Default: CacheMaxExpire 86400 (one day)
Context: сервер config, действительный хозяин
Status: экспериментальный
Module: mod_cache

CacheMaxExpire директива определяет максимальное число секунд, в течение которых cachable HTTP документы будет сохранен, не проверяя сервер происхождения. Таким образом, документы будут устаревшими самое большее это число секунд. Эта максимальная ценность предписана, даже если дата окончания срока действия была снабжена документом.

CacheMaxExpire 604800