From a3756108e68c5e8117f42d1527789e3db75a532d Mon Sep 17 00:00:00 2001 From: MichaIng Date: Mon, 20 Dec 2021 02:07:15 +0100 Subject: [PATCH] Update OPcache documentation Remove the settings block which matches PHP defaults anyway. The Nextcloud admin panel will now show warnings based on actual OPcache usage, when any limit is closely reached: https://github.com/nextcloud/server/pull/27403 Add info about how to enhance performance by reducing or disabling OPcache revalidation. Remove link to outdated blog post, which contains no additional helpful information and the invalid "opcache.fast_shutdown" setting which was removed with PHP7.2 already. Instead, add a link to "opcache-gui", a web interface to monitor and control the OPcache. Signed-off-by: MichaIng --- admin_manual/installation/server_tuning.rst | 23 ++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/admin_manual/installation/server_tuning.rst b/admin_manual/installation/server_tuning.rst index 6e88da170..dce8cc4f3 100644 --- a/admin_manual/installation/server_tuning.rst +++ b/admin_manual/installation/server_tuning.rst @@ -102,15 +102,24 @@ more processes to run in parallel to handle the requests. Enable PHP OPcache ------------------ -The `OPcache `_ improves the performance of PHP applications by caching precompiled bytecode. We recommend at least the following settings: +The `OPcache `_ improves the performance of PHP applications by caching precompiled bytecode. The default OPcache settings are usually sufficient for Nextcloud code to be fully cached. If any cache size limit is reached by more than 90%, the admin panel will show a related warning. Nextcloud strictly requires code comments to be preserved in opcode, which is the default. But in case PHP settings are changed on your system, you may need set the following: .. code:: ini - opcache.enable = 1 - opcache.interned_strings_buffer = 8 - opcache.max_accelerated_files = 10000 - opcache.memory_consumption = 128 opcache.save_comments = 1 - opcache.revalidate_freq = 1 -For more details check out the `official documentation `_ or `this blog post about some recommended settings `_. +By default, cached scripts are revalidated on access to ensure that changes on disk take effect after at most ``2`` seconds. Since Nextcloud handles cache revalidation internally when required, the revalidation frequency can be reduced or completely disabled to enhance performance. Note, however, that it affects manual changes to scripts, including ``config.php``. To check for changes at most every ``60`` seconds, use the following setting: + +.. code:: ini + + opcache.revalidate_freq = 60 + +To disable the revalidation completely: + +.. code:: ini + + opcache.validate_timestamps = 0 + +Any change to ``config.php`` will then require either restarting PHP, manually clearing the cache, or invalidating this particular script. + +For more details check out the `official documentation `_. To monitor OPcache usage, clear individual or all cache entries, `opcache-gui `_ can be used.