| Directive | Type | Modification Scope | Description |
|---|---|---|---|
| zend_optimizerplus.enable | boolean | PHP_INI_SYSTEM | Optimizer+ On/Off switch. When set to Off, code is not optimized. |
| zend_optimizerplus.use_cwd | boolean | PHP_INI_SYSTEM | If set to On, use the current directory as a part of the script key |
| zend_optimizerplus.validate_timestamps | boolean | PHP_INI_ALL | If enabled, the Optimizer+ checks the file timestamps and updates the cache accordingly. |
| zend_optimizerplus.revalidate_freq | integer | PHP_INI_ALL | How often to check file timestamps for changes to the shared memory storage allocation. |
| zend_optimizerplus.revalidate_path | boolean | PHP_INI_ALL | Enables or disables file search in include_path optimization |
| zend_optimizerplus.inherited_hack | boolean | PHP_INI_SYSTEM | Enable this hack as a workaround for "can't redeclare class" errors |
| zend_optimizerplus.dups_fix | boolean | PHP_INI_ALL | Enable this hack as a workaround for "duplicate definition" errors |
| zend_optimizerplus.log_verbosity_level | integer | PHP_INI_SYSTEM | The verbosity of the Optimizer+ log |
| zend_optimizerplus.memory_consumption | integer | PHP_INI_SYSTEM | The Optimizer+ shared memory storage size. The amount of memory for storing precompiled PHP code in Mbytes. |
| zend_optimizerplus.max_accelerated_files | integer | PHP_INI_SYSTEM | The maximum number of keys (scripts) in the Optimizer+ hash table |
| zend_optimizerplus.max_wasted_percentage | integer | PHP_INI_SYSTEM | The maximum percentage of "wasted" memory until a restart is scheduled |
| zend_optimizerplus.consistency_checks | integer | PHP_INI_ALL | Check the cache checksum each N requests |
| zend_optimizerplus.force_restart_timeout | integer | PHP_INI_SYSTEM | How long to wait (in seconds) for a scheduled restart to begin if the cache is not being accessed |
| zend_optimizerplus.blacklist_filename | string | PHP_INI_SYSTEM | The location of the Optimizer+ blacklist file |
| zend_optimizerplus.save_comments | boolean | PHP_INI_SYSTEM | If disabled, all PHPDoc comments are dropped from the code to reduce the size of the optimized code. |
| zend_optimizerplus.fast_shutdown | boolean | PHP_INI_SYSTEM | If enabled, a fast shutdown sequence is used for the accelerated code |
| zend_optimizerplus.optimization_level | integer | PHP_INI_SYSTEM | A bitmask, where each bit enables or disables the appropriate Optimizer+ passes |
| zend_optimizerplus.enable_slow_optimizations | boolean | PHP_INI_SYSTEM | Enables or disables the optimization passes that may take significant time, based on an internal runtime calculation |
The Optimizer+ blacklist file is a text file that holds the names of files that should not be accelerated. The file format is to add each filename to a new line. The filename may be a full path or just a file prefix (i.e., /var/www/x blacklists all the files and directories in /var/www that start with 'x'). Files are usually triggered by one of the following three reasons: <br> 1) Directories that contain auto generated code, like Smarty or ZFW cache.<br> 2) Code that does not work well when accelerated, due to some delayed compile time evaluation. <br> 3) Code that triggers an Optimizer+ bug.
Optimizer+ On/Off switch. When set to Off, code is not optimized.
Type: boolean
Default Value: 1
Available since version 4.0
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). Disablingthe directive improves performance, but may break existing applications.
Type: boolean
Default Value: 1
Available since version 4.0
When disabled, you must reset the Optimizer+ manually or restart the webserver for changes to the filesystem to take effect.<br> The frequancy of the check is controlled by the directive "zend_optimizerplus.revalidate_freq"
Type: boolean
Default Value: 1
Available since version 4.0
How often to check file timestamps for changes to the shared memory storage allocation.
Type: integer
Units: seconds
Default Value: 2
Available since version 4.0
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 won't 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.
Type: boolean
Default Value: 0
Available since version 4.0
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.
Type: boolean
Default Value: 1
Available since version 4.0
Enable this hack as a workaround for "duplicate definition" errors
Type: boolean
Default Value: 0
Available since version 4.0
All Optimizer+ errors go to the Web server log.<br> 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).<br> For "debug" binaries, the default log verbosity level is 4, not 1.
Type: integer
Default Value: 1
Available since version 4.0
The Optimizer+ shared memory storage size. The amount of memory for storing precompiled PHP code in Mbytes.
Type: integer
Units: MBytes
Default Value: 64
Available since version 4.0
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.
Type: integer
Default Value: 2000
Available since version 4.0
The maximum percentage of "wasted" memory until a restart is scheduled
Type: integer
Units: %
Default Value: 5
Available since version 4.0
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.
Type: integer
Default Value: 0
Available since version 4.0
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.
Type: integer
Units: seconds
Default Value: 180
Available since version 4.0
For additional information, see "Extermal Configuration File", above
Type: string
Available since version 4.0
If disabled, all PHPDoc comments are dropped from the code to reduce the size of the optimized code.
Type: boolean
Default Value: 1
Available since version 4.0
The fast shutdown sequence doesn't free each allocated block, but lets the Zend Engine Memory Manager do the work.
Type: boolean
Default Value: 0
Available since version 4.0
A bitmask, where each bit enables or disables the appropriate Optimizer+ features (where 0 is disabled and 1 is enabled).
Type: integer
Default Value: 0xfffffbbf
Available since version 4.0
The following is a list of each bit represented in the value :
bit 0 - Enables/disables optimization step 1:
CSE - constants subexpressions elimination
Sequences of ADD_CHAR/ADD_STRING optimization
bit 1 - Enables/disables optimization step 2:
Convert constant operands to expected types
Convert conditional jumps with constant operands
Optimize static BRK and CONT
bit 2 - Enables/disables optimization step 3:
Convert $a = $a + expr into $a += expr
Convert $a++ into ++$a
Optimize series of JMPs
bit 3 - Enables/disables optimization step 4:
PRINT and ECHO optimization
bit 4 - Enables/disables optimization step 5:
block optimization (the most expensive optimization pass which perform many different optimization patterns based on CFG - control flow graph)
bit 8 - Enables/disables optimization step 9:
register allocation (allows re-usage of temporary variables)
bit 9 - Enables/disables optimization step 10:
remove NOPs