Zend Data Cache - Configuration Directives

This topic lists all the configuration directives for Zend Data Cache.

Configuration Directives Summary

The table below is a summary of all the Zend Data Cache configuration directives, and displays the directive name, its default value, and a description:

Directive

Default Value

Description

zend_datacache.enable_statistics

1

Enable statistics collection

zend_datacache.shm.memory_cache_size

32 / 2

Amount of shared memory to be used by a single namespace (in MB per namespace).

zend_datacache.shm.memory_cache_size_kb

0

Amount of shared memory to be used by a single namespace (in KB per namespace).

zend_datacache.default_miss_cost

100

When the miss cost cannot be evaluated, use this value for statistics purposes

zend_datacache.shm.max_num_namespaces

0

Maximum number of namespaces that Data Cache will allocate.

zend_datacache.default_ttl

0

Set the default life time of a cache entry (seconds). Value of 0 means infinite

zend_datacache.disk.save_path

datacache

The path for storing cached content to the disk

zend_datacache.disk.dir_level

2

Directory depth for storing keys.

zend_datacache.enable

1

Enables the Data Cache. The Data Cache cannot work without this directive. The Data Cache can be turned on or off from the User Interface

zend_datacache.lock_on_expire

1

Enables the lock on expire mechanism. This is ON by default and should stay that way for performance reasons.

zend_datacache.log_verbosity_level

2

The log verbosity level [0-5].

zend_datacache.log_rotation_size

10

The maximum size of the log file before it is rotated.

Configuration Directives Details

The list below contains information for all the available configuration directives for Zend Data Cache: their description, type, units, default value, modification scope, and the Zend Server version they became available in.

zend_datacache.enable_statistics

Enable statistics collection

Default Value: 1

Type: boolean

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 9.2

zend_datacache.shm.memory_cache_size

Amount of shared memory to be used by a single namespace, in Megabytes per namespace

Default Value:

  • Windows, Linux: 32
  • Mac OS X, IBMi: 2

Units: MBytes

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_datacache.shm.memory_cache_size_kb

Amount of shared memory to be used by a single namespace in Kilobytes per namespace. When set to 0, the amount of memory to use is taken from the directive 'memory_cache_size'.

Default Value: 0

Units: KBytes

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 5.5

zend_datacache.default_miss_cost

When the miss cost cannot be evaluated, use this value for statistics purposes

Default Value: 100

Units: milliseconds

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 9.2

zend_datacache.shm.max_num_namespaces

Maximum number of namespaces that Data Cache will allocate. If set to 0, there is no limit.

Default Value: 0

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 5.5

zend_datacache.default_ttl

Set the default life time of a cache entry (seconds). Value of 0 means infinite

Default Value: 0

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 9.2

zend_datacache.disk.save_path

The path for storing cached content to the disk

Default Value: datacache

Type: string

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_datacache.disk.dir_level

Directory depth for storing keys.

Default Value: 2

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_datacache.enable

Enables the Data Cache. The Data Cache cannot work without this directive. The Data Cache can be turned on or off from the User Interface

Default Value: 1

Type: boolean

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_datacache.lock_on_expire

When setting this directive to 1 (i.e. ON), Data Cache will extend the time-to-live of an expired item until a replacement is provided. The first process that attempts to fetch an expired item will receive FALSE, while other processes will keep on receiving the expired item - it is up to the caller to provide a new and updated item.

Default Value: 1

Type: boolean

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_datacache.log_verbosity_level

The extension's log verbosity level. Level 1 includes very important information messages, errors and warnings. Level 2 displays notices. Greater levels (up to 5) are reserved for debug purposes.

Default Value: 2

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_datacache.log_rotation_size

The maximum size of the log file before it is rotated.

Default Value: 10

Units: MBytes

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0