TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,74 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-94665:
+
+============================================
+Deprecation: #94665 - Wincache cache backend
+============================================
+
+See :issue:`94665`
+
+Description
+===========
+
+The Caching Framework backend implementation :php:`TYPO3\CMS\Core\Cache\Backend\WincacheBackend`
+is not maintained since Microsoft dropped its support: A PHP 7.4 compatible version
+came long after PHP 7.4 release and there are no PHP 8.0 works in sight. This backend
+in general found relatively little use and can be substituted with the well
+maintained ApcuBackend key/value store on Windows platforms.
+
+:php:`WincacheBackend` has been marked as deprecated and should not be used anymore.
+
+
+Impact
+======
+
+The implementation has been marked as deprecated, usages trigger a PHP :php:`E_USER_DEPRECATED` error.
+
+
+Affected Installations
+======================
+
+Some instances hosted on Windows platform *may* use this cache backend. This can be
+verified in the backend "Configuration" module, section "TYPO3_CONF_VARS", searching
+for string "WincacheBackend".
+
+
+Migration
+=========
+
+TYPO3 cache backend configuration is usually done in :file:`LocalConfiguration.php`.
+Affected instances could switch to :php:`ApcuBackend` if the :php:`apcu` PHP module
+is loaded, or alternatively to some other backend like :php:`RedisBackend`,
+:php:`MemcachedBackend` or :php:`Typo3DatabaseBackend`, depending on the specific
+cache size and usage characteristics.
+
+
+:file:`LocalConfiguration.php` example before:
+
+.. code-block:: php
+
+    'SYS' => [
+        'caching' => [
+            'cacheConfigurations' => [
+                'aCache' => [
+                    'backend' => 'TYPO3\\CMS\\Core\\Cache\\Backend\\WincacheBackend',
+    ...
+
+:file:`LocalConfiguration.php` example after:
+
+.. code-block:: php
+
+    'SYS' => [
+        'caching' => [
+            'cacheConfigurations' => [
+                'aCache' => [
+                    'backend' => 'TYPO3\\CMS\\Core\\Cache\\Backend\\ApcuBackend',
+    ...
+
+
+In case this cache backend is still used for whatever reason and can't be dropped
+easily, the class should be copied to an own extension having an own namespace. The
+instance configuration needs to be adapted accordingly.
+
+.. index:: LocalConfiguration, PHP-API, NotScanned, ext:core