..  include:: /Includes.rst.txt
..  index:: Events; ModifyCacheLifetimeForPageEvent
..  _ModifyCacheLifetimeForPageEvent:

===============================
ModifyCacheLifetimeForPageEvent
===============================

..  versionadded:: 12.0
    This event serves as a successor for the
    :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['get_cache_timeout']`
    hook.

This event allows to modify the lifetime of how long a rendered page of a
frontend call should be stored in the "pages" cache.

Example
=======

Register the listener:

..  literalinclude:: _ModifyCacheLifetimeForPageEvent/_Services.yaml
    :language: yaml
    :caption: EXT:my_extension/Configuration/Services.yaml

Read :ref:`how to configure dependency injection in extensions <dependency-injection-in-extensions>`.

The following listener limits the cache lifetime to 30 seconds in development
context:

..  literalinclude:: _ModifyCacheLifetimeForPageEvent/_MyEventListener.php
    :language: php
    :caption: EXT:my_extension/Classes/Frontend/EventListener/MyEventListener.php

API
===

..  include:: /CodeSnippets/Events/Frontend/ModifyCacheLifetimeForPageEvent.rst.txt