Zend OPcache Configuration Directives

opcache.enable

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

Type: boolean

Default Value: 1

Available since version 4.0

opcache.use_cwd

When this directive is enabled, the OPcache 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

opcache.validate_timestamps

When disabled, you must reset the OPcache manually or restart the webserver for changes to the filesystem to take effect.<br> The frequancy of the check is controlled by the directive "opcache.revalidate_freq"

Type: boolean

Default Value: 1

Available since version 4.0

opcache.revalidate_freq

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

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

opcache.inherited_hack

The OPcache 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, OPcache 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

opcache.dups_fix

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

Type: boolean

Default Value: 0

Available since version 4.0

opcache.log_verbosity_level

All OPcache 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

opcache.memory_consumption

The OPcache 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

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

Type: integer

Default Value: 2000

Available since version 4.0

opcache.max_wasted_percentage

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

Type: integer

Units: %

Default Value: 5

Available since version 4.0

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

Type: integer

Default Value: 0

Available since version 4.0

opcache.force_restart_timeout

The OPcache uses this directive to identify a situation where there may be a problem with a process. After this time period has passed, the OPcache 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

opcache.blacklist_filename

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

Type: string

Available since version 4.0

opcache.save_comments

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

opcache.fast_shutdown

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

opcache.optimization_level

A bitmask, where each bit enables or disables the appropriate OPcache 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

opcache.enable_slow_optimizations

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

Type: boolean

Default Value: 1

Available since version 4.0

opcache.enable_cli

Enables the opcode cache for the CLI version of PHP. This is mostly useful for testing and debugging.

Type: boolean

Default Value: 1

Available since version 6.3

opcache.error_log

The error log for OPcache errors. An empty string is treated the same as stderr, and will result in logs being sent to standard error (which will be the Web server error log in most cases).

Type: string

Available since version 6.3

opcache.file_update_protection

Prevents caching files that are less than this number of seconds old. It protects from caching of incompletely updated files. In case all file updates on your site are atomic, you may increase performance setting it to 0.

Type: integer

Default Value: 2

Available since version 6.3

opcache.load_comments

If disabled, documentation comments won't be loaded from the opcode cache even if they exist. This can be used with opcache.save_comments to only load comments for applications that require them.

Type: boolean

Default Value: 1

Available since version 6.3

opcache.max_file_size

The maximum file size that will be cached, in bytes. If this is 0, all files will be cached.

Type: integer

Default Value: 0

Available since version 6.3

opcache.protect_memory

Protects shared memory from unexpected writes while executing scripts. This is useful for internal debugging only.

Type: boolean

Default Value: 0

Available since version 6.3

opcache.restrict_api

Allows calling OPcache API functions only from PHP scripts which path is started from specified string. The default means no restriction.

Type: string

Default Value: 1

Available since version 6.3