From b977eadcc0231a5ce2640cc66d241dc7023a737e Mon Sep 17 00:00:00 2001
From: Christoph Lehmann <lehmann@networkteam.com>
Date: Thu, 12 Jan 2023 21:19:27 +0100
Subject: [PATCH] Initial commit

---
 Classes/Hooks/CreateHashBaseHook.php | 13 +++++++++++
 Readme.md                            | 33 ++++++++++++++++++++++++++++
 composer.json                        | 29 ++++++++++++++++++++++++
 ext_localconf.php                    |  6 +++++
 4 files changed, 81 insertions(+)
 create mode 100644 Classes/Hooks/CreateHashBaseHook.php
 create mode 100644 Readme.md
 create mode 100644 composer.json
 create mode 100644 ext_localconf.php

diff --git a/Classes/Hooks/CreateHashBaseHook.php b/Classes/Hooks/CreateHashBaseHook.php
new file mode 100644
index 0000000..0ed39d4
--- /dev/null
+++ b/Classes/Hooks/CreateHashBaseHook.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace Networkteam\CacheBase\Hooks;
+
+use TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController;
+
+class CreateHashBaseHook
+{
+    public function addVariables($params, TypoScriptFrontendController $typoScriptFrontendController)
+    {
+        $params['hashParameters']['networkteam_cachebase'] = $GLOBALS['EXTCONF']['networkteam_cachebase']['keys'];
+    }
+}
\ No newline at end of file
diff --git a/Readme.md b/Readme.md
new file mode 100644
index 0000000..215bb38
--- /dev/null
+++ b/Readme.md
@@ -0,0 +1,33 @@
+# TYPO3 Extension networkteam_cachebase
+
+In container environments with rolling updates there is the point where two versions run parallel and a page cache flush
+is not what we want.
+
+## What does it do?
+
+This extension adds variables to the page cache identifier calculation. For our Use Case it adds the 
+environment variable `SENTRY_RELEASE`, which contains a version number.
+
+More variables can be added like 
+
+```php
+$GLOBALS['EXTCONF']['networkteam_cachebase']['keys']['your_key'] = 'value';
+```
+
+## Installation
+
+```shell
+composer req networkteam/typo3-cachebase
+```
+
+## Background
+
+The page cache hash calculation is based on
+
+* Page row
+* TypoScript Conditions
+* Modification time of loaded TypoScript files
+* Site
+* ... and some more
+
+but changes for example in Fluid Templates are not taken into account.
\ No newline at end of file
diff --git a/composer.json b/composer.json
new file mode 100644
index 0000000..101651e
--- /dev/null
+++ b/composer.json
@@ -0,0 +1,29 @@
+{
+  "name": "networkteam/typo3-cachebase",
+  "type": "typo3-cms-extension",
+  "description": "It adds variables to the page cache identifier calculation for serving multiple versions of a webseite parallel. This is the case in container environments with rolling updates.",
+  "license": "GPL-2.0-or-later",
+  "keywords": [
+    "caching",
+    "container"
+  ],
+  "authors": [
+    {
+      "name": "networkteam",
+      "email": "typo3@networkteam.com"
+    }
+  ],
+  "autoload": {
+    "psr-4": {
+      "Networkteam\\CacheBase\\": "Classes/"
+    }
+  },
+  "require": {
+    "typo3/cms-core": "^11.5 || ^12.0"
+  },
+  "extra": {
+    "typo3/cms": {
+      "extension-key": "networkteam_cachebase"
+    }
+  }
+}
diff --git a/ext_localconf.php b/ext_localconf.php
new file mode 100644
index 0000000..dae5852
--- /dev/null
+++ b/ext_localconf.php
@@ -0,0 +1,6 @@
+<?php
+
+$GLOBALS['EXTCONF']['networkteam_cachebase']['keys']['sentry_release'] = getenv('SENTRY_RELEASE');
+
+$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['createHashBase'][]
+    = \Networkteam\CacheBase\Hooks\CreateHashBaseHook::class . '->addVariables';
\ No newline at end of file