From 747e2868fe13a87893045ad4ade503040a5d988b Mon Sep 17 00:00:00 2001 From: Remi Collet Date: Wed, 27 Mar 2013 18:18:56 +0100 Subject: php: sync opcache.ini with upstream comments --- opcache.ini | 145 ++++++++++++++++++++++-------------------------------------- 1 file changed, 53 insertions(+), 92 deletions(-) diff --git a/opcache.ini b/opcache.ini index 05d75af..4498e68 100644 --- a/opcache.ini +++ b/opcache.ini @@ -1,137 +1,98 @@ ; Enable Zend OPcache extension module zend_extension=@EXTPATH@/opcache.so -; Opcache On/Off switch. When set to Off, code is not optimized. -;opcache.enable=1 +; Determines if Zend OPCache is enabled +opcache.enable=1 + +; Determines if Zend OPCache is enabled for the CLI version of PHP ;opcache.enable_cli=0 -; The OPcache shared memory storage size. The amount of memory for storing -; precompiled PHP code in Mbytes. +; The OPcache shared memory storage size. opcache.memory_consumption=128 -; The amount of memory for interned strings in Mbytes. +; The amount of memory for interned strings in Mbytes. opcache.interned_strings_buffer=8 -; The maximum number of keys (scripts) in the OPcache hash table. -; 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. +; The maximum number of keys (scripts) in the OPcache hash table. +; Only numbers between 200 and 100000 are allowed. opcache.max_accelerated_files=4000 -; The maximum percentage of "wasted" memory until a restart is scheduled. +; The maximum percentage of "wasted" memory until a restart is scheduled. ;opcache.max_wasted_percentage=5 -; When this directive is enabled, the OPcache appends the current working -; directory to the script key, thus eliminating possible collisions between -; files with the same name (basename). Disabling the directive improves -; performance, but may break existing applications. +; When this directive is enabled, the OPcache appends the current working +; directory to the script key, thus eliminating possible collisions between +; files with the same name (basename). Disabling the directive improves +; performance, but may break existing applications. ;opcache.use_cwd=1 -; When disabled, you must reset the OPcache manually or restart the -; webserver for changes to the filesystem to take effect. -; The frequency of the check is controlled by the directive -; "opcache.revalidate_freq". +; When disabled, you must reset the OPcache manually or restart the +; webserver for changes to the filesystem to take effect. ;opcache.validate_timestamps=1 -; How often (in seconds) to check file timestamps for changes to the shared -; memory storage allocation. ("1" means validate once per second, but only -; once per request. "0" means always validate) +; How often (in seconds) to check file timestamps for changes to the shared +; memory storage allocation. ("1" means validate once per second, but only +; once per request. "0" means always validate) ;opcache.revalidate_freq=2 -; Enables or disables file search in include_path optimization -; 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. +; Enables or disables file search in include_path optimization ;opcache.revalidate_path=0 -; If disabled, all PHPDoc comments are dropped from the code to reduce the -; size of the optimized code. +; If disabled, all PHPDoc comments are dropped from the code to reduce the + ;size of the optimized code. ;opcache.save_comments=1 -; If disabled, PHPDoc comments are not loaded from SHM, so "Doc Comments" -; may be always stored (save_comments=1), but not loaded by applications -; that don't need them anyway. +; If disabled, PHPDoc comments are not loaded from SHM, so "Doc Comments" +; may be always stored (save_comments=1), but not loaded by applications +; that don't need them anyway. ;opcache.load_comments=1 - -; If enabled, a fast shutdown sequence is used for the accelerated code -; The fast shutdown sequence doesn't free each allocated block, but lets -; the Zend Engine Memory Manager do the work. +; If enabled, a fast shutdown sequence is used for the accelerated code opcache.fast_shutdown=1 -; Allow file existence override (file_exists, etc.) performance feature. +; Allow file existence override (file_exists, etc.) performance feature. ;opcache.enable_file_override=0 -; A bitmask, where each bit enables or disables the appropriate OPcache -; passes -;opcache.optimization_level="0xffffffff" - -; Enable this hack as a workaround for "can't redeclare class" errors. -; 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. In php-5.3 and above this hack is not needed -; anymore and this setting has no effect. -;opcache.inherited_hack=1 +; A bitmask, where each bit enables or disables the appropriate OPcache +; passes +;opcache.optimization_level=0xffffffff -; Enable this hack as a workaround for "Cannot redeclare class" errors. +;opcache.inherited_hack=1 ;opcache.dups_fix=0 -; The location of the OPcache blacklist file. -; The OPcache 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: -; 1) Directories that contain auto generated code, like Smarty or ZFW cache. -; 2) Code that does not work well when accelerated, due to some delayed -; compile time evaluation. -; 3) Code that triggers an OPcache bug. -;opcache.blacklist_filename - -; Allows exclusion of large files from being cached. -; By default all files are cached. +; The location of the OPcache blacklist file. +; The OPcache 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'). +;opcache.blacklist_filename= + +; Allows exclusion of large files from being cached. By default all files +; are cached. ;opcache.max_file_size=0 -; Check the cache checksum each N requests. -; 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. +; Check the cache checksum each N requests. +; The default value of "0" means that the checks are disabled. ;opcache.consistency_checks=0 -; How long to wait (in seconds) for a scheduled restart to begin if the cache -; is not being accessed. -; 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. +; How long to wait (in seconds) for a scheduled restart to begin if the cache +; is not being accessed. ;opcache.force_restart_timeout=180 -; OPcache error_log file name. Empty string assumes "stderr". -;opcache.error_log=stderr +; OPcache error_log file name. Empty string assumes "stderr". +;opcache.error_log= -; All OPcache 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 messages (level 4). +; All OPcache 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 messages (level 4). ;opcache.log_verbosity_level=1 -; Preferred Shared Memory back-end. Leave empty and let the system decide. +; Preferred Shared Memory back-end. Leave empty and let the system decide. ;opcache.preferred_memory_model= -; Protect the shared memory from unexpected writing during script execution. -; Useful for internal debugging only. +; Protect the shared memory from unexpected writing during script execution. +; Useful for internal debugging only. ;opcache.protect_memory=0 -- cgit