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.shm.memory_cache_size

32 / 2

Amount of shared memory to be used by a single namespace.

zend_datacache.shm.memory_cache_size_kb

0

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

zend_datacache.shm.max_num_namespaces

0

Maximum number of namespaces that Data Cache will allocate.

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.apc_compatibility

1

When enabled, the Data Cache extension registers APC compatibility methods.

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.shm.memory_cache_size

Amount of shared memory to be used by a single 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 KiB). When set to 0, the amount of memory to use is taken from the directove 'memory_cache_size'.

Default Value: 0

Units: KBytes

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 5.5

zend_datacache.shm.max_num_namespaces

Maximum number of namespaces that Data Cache will allocate.

Default Value: 0

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 5.5

zend_datacache.disk.save_path

The path for storing cached content to the disk

Default Value: datacache

Type: string

Modification Scope: ZEND_INI_SYSTEM

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 NULL, 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.apc_compatibility

When enabled, the Data Cache extension registers APC compatibility methods.

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