chore: use CacheDataCollector for adding cache tags in DataHandler chapter (#5274)

This API was introduced with TYPO3 v13.3 and is a successor of
`TypoScriptFrontendController->addCacheTags()`.

Related: TYPO3-Documentation/Changelog-To-Doc#1042
Releases: main, 13.4

Author: brotkrueml

Documentation/ApiOverview/DataHandler/Database/Index.rst

@@ -624,6 +624,14 @@ custom ViewHelper):
     :language: php
     :caption: EXT:my_extension/Classes/Controller/SomeController.php
 
+..  versionadded:: 13.3
+    The :ref:`frontend.cache.collector <typo3-request-attribute-frontend-cache-collector>`
+    request attribut has been introduced as a successor of the now deprecated
+    :php:`TypoScriptFrontendController->addCacheTags()` method. Switch to
+    another version of this page for an example in an older TYPO3 version. For
+    compatibility with TYPO3 v12 and v13 use
+    :php:`TypoScriptFrontendController->addCacheTags()`.
+
 Hook for cache post-processing
 ------------------------------
 

Documentation/ApiOverview/DataHandler/Database/_SomeController.php

@@ -6,20 +6,21 @@
 
 use MyVendor\MyExtension\Domain\Model\ExampleModel;
 use Psr\Http\Message\ResponseInterface;
+use TYPO3\CMS\Core\Cache\CacheDataCollector;
+use TYPO3\CMS\Core\Cache\CacheTag;
 use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;
-use TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController;
 
 final class SomeController extends ActionController
 {
     public function showAction(ExampleModel $example): ResponseInterface
     {
         // ...
 
-        /** @var TypoScriptFrontendController $frontendController */
-        $frontendController = $this->request->getAttribute('frontend.controller');
-        $frontendController->addCacheTags([
-            sprintf('tx_myextension_example_%d', $example->getUid()),
-        ]);
+        /** @var CacheDataCollector $cacheDataCollector */
+        $cacheDataCollector = $this->request->getAttribute('frontend.cache.collector');
+        $cacheDataCollector->addCacheTags(
+            new CacheTag(sprintf('tx_myextension_example_%d', $example->getUid())),
+        );
 
         // ...
     }