Модуль Apache mod_cache_socache
| Описание: | Модуль хранения на основе общего кэша объектов (socache) для фильтра кэширования HTTP. |
|---|---|
| Статус: | Расширение |
| Идентификатор модуля: | cache_socache_module |
| Исходный файл: | mod_cache_socache.c |
Краткое описание
mod_cache_socache реализует менеджер хранения на основе общего кэша объектов (socache) для mod_cache.
Заголовки и тела кэшированных ответов объединяются и сохраняются под одним ключом в общем кэше объектов. На выбор доступны несколько реализаций общих кэшей объектов.
Несколько ответов с согласованием содержимого могут храниться одновременно, однако этот модуль пока не поддерживает кэширование частичного содержимого.
# Turn on caching
CacheSocache shmcb
CacheSocacheMaxSize 102400
<Location "/foo">
CacheEnable socache
</Location>
# Fall back to the disk cache
CacheSocache shmcb
CacheSocacheMaxSize 102400
<Location "/foo">
CacheEnable socache
CacheEnable disk
</Location> Примечание:
mod_cache_socache требует сервисов mod_cache, который должен быть загружен до mod_cache_socache.
Директива CacheSocache
| Описание: | Реализация общего кэша объектов, которую следует использовать |
|---|---|
| Синтаксис: | CacheSocache type[:args] |
| Контекст: | конфигурация сервера, виртуальный хост |
| Статус: | Расширение |
| Модуль: | mod_cache_socache |
| Совместимость: | Доступна в Apache 2.4.5 и более поздних версиях |
Директива CacheSocache задаёт имя используемой реализации общего кэша объектов, за которым могут следовать необязательные аргументы этой реализации. На выбор доступны несколько реализаций общих кэшей объектов.
CacheSocache shmcb
Директива CacheSocacheMaxSize
| Описание: | Максимальный размер (в байтах) записи, помещаемой в кэш |
|---|---|
| Синтаксис: | CacheSocacheMaxSize bytes |
| Значение по умолчанию: | CacheSocacheMaxSize 102400 |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Статус: | Расширение |
| Модуль: | mod_cache_socache |
| Совместимость: | Доступна в Apache 2.4.5 и более поздних версиях |
Директива CacheSocacheMaxSize задаёт максимальный размер в байтах для объединённых заголовков и тела документа, при котором документ может быть сохранён в кэше. Чем больше размер заголовков, сохраняемых вместе с телом, тем меньше может быть тело.
Модуль mod_cache_socache будет пытаться кэшировать только ответы с явно заданной длиной содержимого или ответы, которые достаточно малы, чтобы быть записанными за один проход. Это позволяет модулю mod_cache_disk получить возможность кэшировать ответы, размер которых превышает допустимый для mod_cache_socache.
CacheSocacheMaxSize 102400
Директива CacheSocacheMaxTime
| Описание: | Максимальное время (в секундах), в течение которого документ может храниться в кэше |
|---|---|
| Синтаксис: | CacheSocacheMaxTime seconds |
| Значение по умолчанию: | CacheSocacheMaxTime 86400 |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Статус: | Расширение |
| Модуль: | mod_cache_socache |
| Совместимость: | Доступна в Apache 2.4.5 и более поздних версиях |
Директива CacheSocacheMaxTime задаёт максимальное время свежести документа в секундах, в течение которого он хранится в кэше. Это значение переопределяет время свежести документа, заданное протоколом HTTP.
CacheSocacheMaxTime 86400
Директива CacheSocacheMinTime
| Описание: | Минимальное время (в секундах), в течение которого документ может храниться в кэше |
|---|---|
| Синтаксис: | CacheSocacheMinTime seconds |
| Значение по умолчанию: | CacheSocacheMinTime 600 |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Статус: | Расширение |
| Модуль: | mod_cache_socache |
| Совместимость: | Доступна в Apache 2.4.5 и более поздних версиях |
Директива CacheSocacheMinTime задаёт, сколько секунд после окончания времени свежести ответа он должен храниться в общем кэше объектов. Если ответ хранится только в течение времени свежести, возможности повторно проверить его и снова сделать свежим не будет.
CacheSocacheMinTime 600
Директива CacheSocacheReadSize
| Описание: | Минимальный размер документа (в байтах), который необходимо прочитать и кэшировать перед отправкой данных далее по цепочке |
|---|---|
| Синтаксис: | CacheSocacheReadSize bytes |
| Значение по умолчанию: | CacheSocacheReadSize 0 |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Статус: | Расширение |
| Модуль: | mod_cache_socache |
| Совместимость: | Доступна в Apache 2.4.5 и более поздних версиях |
Директива CacheSocacheReadSize задаёт минимальный объём данных в байтах, который необходимо прочитать от бэкенда до отправки данных клиенту. Значение по умолчанию, равное нулю, приводит к тому, что все прочитанные данные любого размера сразу передаются далее клиенту по мере поступления. Если задать большее значение, дисковый кэш будет буферизовать как минимум указанный объём данных перед отправкой результата клиенту. Это может повысить производительность при кэшировании содержимого от медленного обратного прокси-сервера.
Эта директива действует только при сохранении данных в кэше, но не при выдаче данных из кэша.
CacheSocacheReadSize 102400
Директива CacheSocacheReadTime
| Описание: | Минимальное время (в миллисекундах), которое должно пройти во время чтения до отправки данных далее по цепочке |
|---|---|
| Синтаксис: | CacheSocacheReadTime milliseconds |
| Значение по умолчанию: | CacheSocacheReadTime 0 |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Статус: | Расширение |
| Модуль: | mod_cache_socache |
| Совместимость: | Доступна в Apache 2.4.5 и более поздних версиях |
Директива CacheSocacheReadTime задаёт минимальное время, которое должно пройти до попытки отправить данные далее по цепочке клиенту. В течение этого времени данные буферизуются перед отправкой результата клиенту. Это может повысить производительность при кэшировании содержимого от обратного прокси-сервера.
Значение по умолчанию, равное нулю, отключает этот параметр.
Эта директива действует только при сохранении данных в кэше, но не при выдаче данных из кэша. Рекомендуется использовать этот параметр вместе с директивой CacheSocacheReadSize, чтобы сервер не буферизовал чрезмерный объём данных, если они поступают быстрее ожидаемого.
CacheSocacheReadTime 1000
© 2018 The Apache Software Foundation
Licensed under the Apache License, Version 2.0.
https://httpd.apache.org/docs/2.4/en/mod/mod_cache_socache.html
