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,71 @@
+
+.. include:: /Includes.rst.txt
+
+.. _feature-64200:
+
+==================================================
+Feature: #64200 - Allow individual content caching
+==================================================
+
+See :issue:`64200`
+
+Description
+===========
+
+The `stdWrap.cache.` property is now available as first-class function to all
+content objects. This skips the rendering even for content objects that evaluate
+`stdWrap` after rendering (e.g. `COA`).
+
+Usage:
+
+.. code-block:: typoscript
+
+	page = PAGE
+	page.10 = COA
+	page.10 {
+		cache.key = coaout
+		cache.lifetime = 60
+		#stdWrap.cache.key = coastdWrap
+		#stdWrap.cache.lifetime = 60
+		10 = TEXT
+		10 {
+			cache.key = mycurrenttimestamp
+			cache.lifetime = 60
+			data = date : U
+			strftime = %H:%M:%S
+			noTrimWrap = |10: | |
+		}
+		20 = TEXT
+		20 {
+			data = date : U
+			strftime = %H:%M:%S
+			noTrimWrap = |20: | |
+		}
+	}
+
+The commented part is `stdWrap.cache.` property available since 4.7,
+that does not stop the rendering of `COA` including all sub-cObjects.
+
+Additionally, stdWrap support is added to key, lifetime and tags.
+
+
+Impact
+======
+
+If you've previously used the `cache.` property in your custom cObject,
+this will now fail, because `cache.` is unset to avoid double caching.
+You are encouraged to rely on the core methods for caching cObjects or
+rename your property.
+
+`stdWrap.cache` continues to exists and can be used as before. However
+the top level `stdWrap` of certain cObjects (e.g. `TEXT` cObject)
+will not evaluate `cache.` as part of `stdWrap`, but before starting
+the rendering of the cObject. In conjunction the storing will happen
+after the `stdWrap` processing right before the content is returned.
+
+Top level `cache.` will not evaluate the hook
+`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['stdWrap_cacheStore']`
+any more.
+
+
+.. index:: PHP-API, TypoScript, Frontend