Attention
TYPO3 v9 has reached its end-of-life September 30th, 2021 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.
You can order Extended Long Term Support (ELTS) here: TYPO3 ELTS.
Configuration¶
Caches are configured in the array $GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']
.
The basic structure is predefined in typo3/sysext/core/Configuration/DefaultConfiguration.php
,
and consists of the single section:
cacheConfigurations: Registry of all configured caches. Each cache is identified by its array key. Each cache can have the sub keys frontend, backend and options to configure the used frontend, backend and possible backend options.
Cache Configurations¶
Unfortunately in TYPO3 CMS, all ext_localconf.php
files of the extensions are loaded after the instance specific
configuration from LocalConfiguration.php
and AdditionalConfiguration.php
. This
enables extensions to overwrite cache configurations already done for the instance. All extensions
should avoid this situation and should just define the very bare minimum of cache configurations. This
boils down to define just the array key to populate a new cache to the system. Without further configuration,
the cache system falls back to the default backend and default frontend settings:
if (!is_array($GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['myext_mycache'])) {
$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['myext_mycache'] = [];
}
Extensions like extbase define default caches this way, giving administrators full freedom for specific and possibly quicker setups (eg. a memory driven cache for the Extbase reflection cache).
Administrators can overwrite specific settings of the cache configuration in LocalConfiguration.php
,
example configuration to switch cache_pages to the redis backend using database 3:
return [
'SYS' => [
'caching' => [
'cacheConfigurations' => [
'cache_pages' => [
'backend' => \TYPO3\CMS\Core\Cache\Backend\RedisBackend::class,
'options' => [
'database' => 3,
],
],
],
],
],
];
Some backends have mandatory as well as optional parameters (which are documented below). If not all mandatory options are defined, the specific backend will throw an exception if accessed.
How to Disable Specific Caches¶
During development, it can be convenient to disable certain caches. This is especially helpful since TYPO3 CMS 4.6 for central caches like the language or autoloader cache. This can be achieved by using the null backend (see below) as storage backend.
Warning
Do not use this in production, it will strongly slow down the system!
Example entry to switch the extbase_reflection cache to use the null backend:
$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']
['extbase_reflection']['backend'] = \TYPO3\CMS\Core\Cache\Backend\NullBackend::class;