---
title: "Events"
manual: "Warming"
version: "5.3"
permalink: "https://docs.typo3.org/permalink/eliashaeussler/typo3-warming:events@5.3"
source: "DeveloperCorner/Events.rst"
rendered: "2026-11-05T08:37:00+00:00"
---

# Events {#events}

<!-- TODO: no Markdown rendering for "versionadded" -->

Feature #338 – Introduce events

During cache warmup, some [PSR-14 events](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/Events/EventDispatcher/Index.html#eventdispatcher)
are dispatched. Events can be used to step in the cache warmup
lifecycle and affect its crawling behavior in various ways.

> [!NOTE]
> The [`eliashaeussler/cache-warmup`](https://packagist.org/packages/eliashaeussler/cache-warmup) library also dispatches some events.
> Read more in the [official documentation](https://cache-warmup.dev/api/events.html).

The following events are currently dispatched:

## BeforeCacheWarmupEvent {#before-cache-warmup-event}

This event is dispatched right before cache warmup is triggered
via `\EliasHaeussler\CacheWarmup\CacheWarmer::run`. It
allows to add additional sitemaps and URLs to the cache warmer or
modify the crawling behavior in other ways.

## AfterCacheWarmupEvent {#after-cache-warmup-event}

Once cache warmup is finished, this event is dispatched. It
provides the cache warmup result together with the original
instance of `\EliasHaeussler\CacheWarmup\CacheWarmer`
and the used crawler.

> [!NOTE]
> **See also**
>
> View the sources on GitHub:
>
> -   [AfterCacheWarmupEvent](https://github.com/eliashaeussler/typo3-warming/blob/main/Classes/Event/AfterCacheWarmupEvent.php)
> -   [BeforeCacheWarmupEvent](https://github.com/eliashaeussler/typo3-warming/blob/main/Classes/Event/BeforeCacheWarmupEvent.php)