API Reference Guide > Zend Optimizer+ Configuration Directives

Zend Optimizer+ - Configuration Directives

This topic lists all the configuration directives for Zend Optimizer+.

Configuration Directives Summary

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

Directive	Default Value	Description
zend_optimizerplus.enable	1	Optimizer+ On/Off switch. When set to Off, code is not optimized.
zend_optimizerplus.use_cwd	1	If set to On, use the current directory as a part of the script key.
zend_optimizerplus.validate_timestamps	1	If enabled, the Optimizer+ checks the file timestamps and updates the cache accordingly.
zend_optimizerplus.revalidate_freq	2	How often to check file timestamps for changes to the shared memory storage allocation.
zend_optimizerplus.revalidate_path	0	Enables or disables file search in include_path optimization
zend_optimizerplus.inherited_hack	1	Enable this hack as a workaround for "can't redeclare class" errors
zend_optimizerplus.dups_fix	0	Enable this hack as a workaround for "duplicate definition" errors.
zend_optimizerplus.log_verbosity_level	1	The verbosity of the Optimizer+ log.
zend_optimizerplus.memory_consumption	64	The Optimizer+ shared memory storage size. The amount of memory for storing precompiled PHP code in Mbytes.
zend_optimizerplus.interned_strings_buffer	4	The amount of memory for interned strings in Mbytes.
zend_optimizerplus.max_accelerated_files	2000	The maximum number of keys (scripts) in the Optimizer+ hash table.
zend_optimizerplus.max_wasted_percentage	5	The maximum percentage of "wasted" memory until a restart is scheduled.
zend_optimizerplus.consistency_checks	0	Check the cache checksum each N requests.
zend_optimizerplus.force_restart_timeout	180	Time duration (in seconds) for waiting for a scheduled restart to begin if the cache is not being accessed.
zend_optimizerplus.blacklist_filename		The location of the Optimizer+ blacklist file.
zend_optimizerplus.save_comments	1	If disabled, all PHPDoc comments are dropped from the code to reduce the size of the optimized code.
zend_optimizerplus.fast_shutdown	0	If enabled, a fast shutdown sequence is used for the accelerated code.
zend_optimizerplus.optimization_level	0xfffffbbf	A bitmask, where each bit enables or disables the appropriate Optimizer+ passes.
zend_optimizerplus.enable_slow_optimizations	1	Enables or disables the optimization passes that may take a significant amount of time, based on an internal runtime calculation.

Configuration Directives Details

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

zend_optimizerplus.enable

Optimizer+ On/Off switch. When set to Off, code is not optimized.

Default Value: 1

Type: boolean

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.use_cwd

When this directive is enabled, the Optimizer+ appends the current working directory to the script key, thus elminating possible collisions between files with the same name (basename). Disabling the directive improves performance, but may break existing applications.

Default Value: 1

Type: boolean

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.validate_timestamps

When disabled, you must reset the Optimizer+ manually or restart the webserver for changes to the filesystem to take effect.
The frequancy of the check is controlled by the directive "zend_optimizerplus.revalidate_freq".

Default Value: 1

Type: boolean

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_optimizerplus.revalidate_freq

How often to check file timestamps for changes to the shared memory storage allocation.

Default Value: 2

Units: seconds

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_optimizerplus.revalidate_path

If the file search is disabled and a cached file is found that uses the same include_path, the file is not searched again. Thus, if a file with the same name appears somewhere else in include_path, it will not be found. Enable this directive if this optimization has an effect on your applications. The default for this directive is disabled, which means that optimization is active.

Default Value: 0

Type: boolean

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_optimizerplus.inherited_hack

The Optimizer+ stores the places where DECLARE_CLASS opcodes use inheritance (These are the only opcodes that can be executed by PHP, but which may not be executed because the parent class is missing due to optimization). When the file is loaded, Optimizer+ tries to bind the inherited classes by using the current environment. The problem with this scenario is that, while the DECLARE_CLASS opcode may not be needed for the current script, if the script requires that the opcode at least be defined, it may not run. The default for this directive is disabled, which means that optimization is active. In php-5.3 and above this hack is not needed anymore and this setting has no effect.

Default Value: 1

Type: boolean

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.dups_fix

Enable this hack as a workaround for "duplicate definition" errors.

Default Value: 0

Type: boolean

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_optimizerplus.log_verbosity_level

All Optimizer+ errors go to the Web server log.
By default, only fatal errors (level 0) or errors (level 1) are logged. You can also enable warnings (level 2), info messages (level 3) or debug messesges (level 4).
For "debug" binaries, the default log verbosity level is 4, not 1.

Default Value: 1

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.memory_consumption

The Optimizer+ shared memory storage size. The amount of memory for storing precompiled PHP code in Mbytes.

Default Value: 64

Units: MBytes

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.interned_strings_buffer

The amount of memory for interned strings in Mbytes.

Default Value: 4

Units: MBytes

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.max_accelerated_files

The number is actually the the first one in the following set of prime numbers that is bigger than the one supplied: { 223, 463, 983, 1979, 3907, 7963, 16229, 32531, 65407, 130987 }. Only numbers between 200 and 100000 are allowed.

Default Value: 2000

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.max_wasted_percentage

The maximum percentage of "wasted" memory until a restart is scheduled.

Default Value: 5

Units: %

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.consistency_checks

The default value of "0" means that the checks are disabled. Because calculating the checksum impairs performance, this directive should be enabled only as part of a debugging process.

Default Value: 0

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_optimizerplus.force_restart_timeout

The Optimizer+ uses this directive to identify a situation where there may be a problem with a process. After this time period has passed, the Optimizer+ assumes that something has happened and starts killing the processes that still hold the locks that are preventing a restart. If the log level is 3 or above, a "killed locker" error is recorded in the Apache logs when this happens.

Default Value: 180

Units: seconds

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.blacklist_filename

For additional information, see "Extermal Configuration File" above.

Default Value:

Type: string

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.save_comments

If disabled, all PHPDoc comments are dropped from the code to reduce the size of the optimized code.

Default Value: 1

Type: boolean

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.fast_shutdown

The fast shutdown sequence doesn't free each allocated block, but lets the Zend Engine Memory Manager do the work.

Default Value: 0

Type: boolean

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.optimization_level

A bitmask, where each bit enables or disables the appropriate Optimizer+ passes.

Default Value: 0xfffffbbf

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_optimizerplus.enable_slow_optimizations

Enables or disables the optimization passes that may take a significant amount of time, based on an internal runtime calculation.

Default Value: 1

Type: boolean

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

Open this topic with navigation

	Zend.com
	Knowledge Base
	Support Center
	Zend Forums
	DevZone
	PHP Manual

	Zend Server 6.2
	Zend Server 6.1
	Zend Server 6.0
	Zend Server 5.6