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,60 @@
+.. include:: /Includes.rst.txt
+
+.. _feature-90197:
+
+=======================================================
+Feature: #90197 - Introduce cache:flush console command
+=======================================================
+
+See :issue:`90197`
+
+Description
+===========
+
+It is now possible to flush TYPO3 caches using the command line.
+
+The administrator can use the following CLI command:
+
+.. code-block:: bash
+
+   ./typo3/sysext/core/bin/typo3 cache:flush
+
+Specific cache groups can be defined via the group option.
+The usage is described as:
+
+.. code-block:: bash
+
+   cache:flush [--group <all|system|di|pages|…>]
+
+All available cache groups can be supplied as option. The command defaults to
+flush all available cache groups as the install tool does.
+
+Extensions that register custom caches may listen to the
+via :php:`TYPO3\CMS\Core\Cache\Event\CacheFlushEvent`, but usually the
+cache flush via CacheManager groups will suffice.
+
+Impact
+======
+
+It is often required to clear caches during deployment of TYPO3 instance
+updates, in order for content changes to become active.
+
+TYPO3 caches can now be flushed in release postparatory steps. The integrator
+may decide to flush all caches (common practice with `EXT:typo3_console`) or
+may alternatively flush selected groups (e.g. 'pages') in case the `cache:warmup`
+(see :issue:`93436`) command is used as companion in release preparatory steps.
+
+Deployment steps could then be:
+
+* Release preparation:
+
+  * git-checkout/rsync your codebase (on CI or on live system)
+  * `composer install` (on CI or on live system)
+  * `vendor/bin/typo3 cache:warmup --group system` (*only* on the live system)
+
+* Change release symlink to the new release folder
+* Release postparation
+
+  * `vendor/bin/typo3 cache:flush --group pages`
+
+.. index:: CLI, ext:core