.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ===================================== EXT: Caching Framework Lifetime Patch ===================================== :Created: 2010-02-18T17:33:18 :Changed by: Sven Tappert :Changed: 2013-08-02T17:46:28.830000000 :Classification: cf_lifetime_patch :Keywords: caching framework :Author: Sven Tappert :Email: typo3@sven-t.de :Info 4: :Language: en |img-1| |img-2| EXT: Caching Framework Lifetime Patch - cf\_lifetime\_patch .. _EXT-Caching-Framework-Lifetime-Patch: EXT: Caching Framework Lifetime Patch ===================================== Extension Key: cf\_lifetime\_patch Language: en Keywords: caching framework Copyright 2013, Sven Tappert, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.org .. _Table-of-Contents: Table of Contents ----------------- `EXT: Caching Framework Lifetime Patch 1 <#__RefHeading__704_179464138>`_ **`Introduction 3 <#__RefHeading__706_179464138>`_** `What does it do? 3 <#__RefHeading__708_179464138>`_ `Screenshots 3 <#__RefHeading__710_179464138>`_ **`Users manual 4 <#__RefHeading__712_179464138>`_** **`Administration 5 <#__RefHeading__2694_623485719>`_** **`Configuration 6 <#__RefHeading__720_179464138>`_** `FAQ 6 <#__RefHeading__722_179464138>`_ `Reference 6 <#__RefHeading__724_179464138>`_ **`Known problems 7 <#__RefHeading__728_179464138>`_** **`ChangeLog 8 <#__RefHeading__732_179464138>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ The cache lifetime in the “new” caching framework (it was introduced in typo3 version 4.5) currently sets a default timestamp of 3600 seconds (1 hour) for the pagesection cache and the rootline cache (Typo3 Version 6.0). This might be correct, but for some reason the whole page cache is rendered again after the pagesection cache expires (the rootline cache does seem to have a big effect). This is absolutely independent from the TypoScript setting config.cache\_period. This leads to a cache timeout and regeneration for every page after one hour, disabling the cache\_period configuration more or less and producing heavy extra load on the server. This extension sets the lifetime of these two caches to unlimited (default) or to some user defined value. So the caches are only getting regenerated when the page cache times out, the frontend cache is cleared or the configured lifetime expires. Please note, that this is just a (good working) fix but it does not resolve the bug in the caching system itself. This patch addresses issues `http://forge.typo3.org/issues/39295 `_ and `http://forge.typo3.org/issues/50231 `_ .. _Note: Note: """"" From version 1.2.0 this extension just (re)sets the configuration values for the caching framework cache lifetimes in:$GLOBALS['TYPO3\_C ONF\_VARS']['SYS']['caching']['cacheConfigurations'][]['o ptions']['defaultLifetime'] This could be also done manually in typo3conf/AdditionalConfiguration.php (Typo3 6.x.) or in typo3conf/localconf.php (Typo3 4.x) .. _Screenshots: Screenshots ^^^^^^^^^^^ |img-3| The extensions configuration settings. Set the cache lifetime in seconds. The default value (unlimited cache lifetime = 0) is currently the recommended setting. .. _Users-manual: Users manual ------------ It just needs to be installed. Default configuration will work. If you experience a never expiring cache (i.e. cache persists longer than configured in TS setup) set this to the same value as in TS setup (config.cache\_period). .. _Administration: Administration -------------- The extension needs to be installed and will work. Clear the whole typo3 cache if you want to make sure the that the caches are regenerated with the new expiry timestamps. If you want to change the cache lifetime, you can use the extension configuration page. It's accessible via the extension manager. .. _Configuration: Configuration ------------- The extension does not provide or need any TS templates to be included or any TS Setup at all. Cache lifetimes, can be set on the general extensions configuration. It's accessible via the extension manager. The default value (0 = unlimited cache lifetime) is currently the recommended setting for both caches. Alternatively you can use the same value as in the TS setup for config.cache\_period. The rootline cache only affects Typo3 versions 6.0 and above. .. _FAQ: FAQ ^^^ - Is it useful to set the lifetime to another value than zero? - To be honest: I don't know yet... - Are there any problems with unlimited cache lifetimes for pagesections and rootline? - As far as I can say, it's the perfect value for these caches. The cache will be regenerated when the correspondent page cache expires or the cache is cleared. To be really, really honest: see above.. if you experience any strange behavior, please let me know!In case of doubt use the same value as in your TS setup (config.cache\_period). .. _Reference: Reference ^^^^^^^^^ Extension configuration (extension configuration via the extension manager, no TS Setup) .. ### BEGIN~OF~TABLE ### .. _pagesection-cache-period: pagesection\_cache\_period """""""""""""""""""""""""" .. container:: table-row Property pagesection\_cache\_period Data type int+ Description Cache lifetime in seconds for pagesection cache. “0” sets expiry to unlimited. Empty value “” restores the default system lifetime (3600 in current typo3 branches). Default 0 .. _rootline-cache-period: rootline\_cache\_period """"""""""""""""""""""" .. container:: table-row Property rootline\_cache\_period Data type int+ Description Cache lifetime in seconds for rootline cache. This cache is not used in typo3 versions of the 4.x branch. “0” sets expiry to unlimited. Empty value “” restores the default system lifetime (3600 in current typo3 branches). Default 0 .. ###### END~OF~TABLE ###### .. _Known-problems: Known problems -------------- Nothing yet, but: - XCLASS usage was removed in version 1.2.0. The extension now just manipulates the config values for the cache lifetimes.So if you configured them manually these values will be overridden. - If you experience any problems, please let me know. .. _ChangeLog: ChangeLog --------- .. ### BEGIN~OF~TABLE ### .. _1-2-1: 1.2.1 ^^^^^ .. container:: table-row Version 1.2.1 Changes Extension description update. .. _1-2-0: 1.2.0 ^^^^^ .. container:: table-row Version 1.2.0 Changes Removed XCLASS and Hook usage. The extension now just manipulates the config settings. .. _1-1-2: 1.1.2 ^^^^^ .. container:: table-row Version 1.1.2 Changes Added the manual and – the extension ICON! .. _1-1-1: 1.1.1 ^^^^^ .. container:: table-row Version 1.1.1 Changes Modified version dependency information .. _1-1-0: 1.1.0 ^^^^^ .. container:: table-row Version 1.1.0 Changes Added patches for 4.5, 4.6 and 4.7 .. _1-0-0: 1.0.0 ^^^^^ .. container:: table-row Version 1.0.0 Changes First release. Patch for typo3 6.x branches .. ###### END~OF~TABLE ###### |img-2| 8 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 292 .. :id: Grafik1 .. :name: Grafik1 .. :width: 602