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

Apache Module mod_mem_cache

Description: Content cache keyed to URIs
Status: Experimental
Module Identifier: mem_cache_module
Source File: mod_mem_cache.c

Summary

This module is experimental. Documentation is still under development...

mod_mem_cache implements a memory based storage manager. mod_mem_cache can be configured to operate in two modes: caching open file descriptors or caching objects in heap storage. mod_mem_cache is most useful when used to cache locally generated content or to cache backend server content for mod_proxy configured for ProxyPass (aka reverse proxy)

Content is stored in and retrieved from the cache using URI based keys. Content with access protection is not cached.

Note:

mod_mem_cache requires the services of mod_cache.

Directives

top

MCacheMaxObjectCount Directive

Description: The maximum number of objects allowed to be placed in the cache
Syntax: MCacheMaxObjectCount value
Default: MCacheMaxObjectCount 1009
Context: server config, virtual host
Status: Experimental
Module: mod_mem_cache

The MCacheMaxObjectCount directive sets the maximum number of objects to be cached. If a new object needs to be inserted in the cache and the maximum number of objects has been reached, an object will be removed to allow the new object to be cached. The object to be removed is selected using the algorithm specified by MCacheRemovalAlgorithm.

Note:

The value of MCacheMaxObjectCount is used to create the open hash table.

MCacheMaxObjectCount 13001

top

MCacheMaxObjectSize Directive

Description: The maximum size (in bytes) of a document allowed in the cache
Syntax: MCacheMaxObjectSize bytes
Default: MCacheMaxObjectSize 10000
Context: server config, virtual host
Status: Experimental
Module: mod_mem_cache

The MCacheMaxObjectSize directive sets the maximum allowable size, in bytes, of a document for it to be considered cacheable.

Note:

The value of MCacheMaxObjectSize must be greater than the value specified by the MCacheMinObjectSize directive.

MCacheMaxObjectSize 6400000

top

MCacheMinObjectSize Directive

Description: The minimum size (in bytes) of a document to be allowed in the cache
Syntax: MCacheMinObjectSize bytes
Default: MCacheMinObjectSize 0
Context: server config, virtual host
Status: Experimental
Module: mod_mem_cache

The MCacheMinObjectSize directive sets the minimum size in bytes of a document for it to be considered cacheable.

MCacheMinObjectSize 10000

top

MCacheRemovalAlgorithm Directive

Description: The algorithm used to select documents for removal from the cache
Syntax: MCacheRemovalAlgorithm LRU|GDSF
Default: MCacheRemovalAlgorithm GDSF
Context: server config, virtual host
Status: Experimental
Module: mod_mem_cache

The MCacheRemovalAlgorithm directive specifies the algorithm used to select documents for removal from the cache. Two choices are available:
LRU (Least Recently Used): LRU removes the documents that have not been accessed for the longest time.
GDSF (GreadyDual-Size): GDSF assigns a priority to cached documents based on the cost of a cache miss and the size of the document. Documents with the lowest priority are removed first.

MCacheRemovalAlgorithm GDSF
MCacheRemovalAlgorithm LRU

top

MCacheSize Directive

Description: The maximum amount of memory used by the cache in KBytes
Syntax: MCacheSize KBytes
Default: MCacheSize 100
Context: server config, virtual host
Status: Experimental
Module: mod_mem_cache

The MCacheSize directive sets the maximum amount of memory to be used by the cache, in KBytes (1024-byte units). If a new object needs to be inserted in the cache and the size of the object is greater than the remaining memory, objects will be removed until the new object can be cached. The object to be removed is selected using the algorithm specified by MCacheRemovalAlgorithm.

Note:

The MCacheSize value must be greater than the value specified by the MCacheMaxObjectSize directive.

MCacheSize 700000