---
title: "Breaking: #108277 - Remove superfluous CacheHashCalculator public methods"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:breaking-108277-1763903595"
source: "Changelog/14.0/Breaking-108277-RemoveSuperfluousCacheHashCalculatorPublicMethods.rst"
typo3-version: "14.0"
typo3-major: 14
type: "breaking"
issue: 108277
forge: "https://forge.typo3.org/issues/108277"
tags: ["Frontend", "FullyScanned", "ext:core"]
rendered: "2026-09-28T19:48:07+00:00"
---

# Breaking: #108277 - Remove superfluous CacheHashCalculator public methods {#breaking-108277-1763903595}

See [forge#108277](https://forge.typo3.org/issues/108277)

## Description {#description}

The following superfluous public methods have been removed:

-   `\TYPO3\CMS\Frontend\Page\CacheHashCalculator::setConfiguration()`
-   `\TYPO3\CMS\Frontend\Page\CacheHashConfiguration::with()`

## Impact {#impact}

Calling the removed methods will result in a fatal PHP error.

Both methods were only used internally for testing purposes and were not part
of the public API contract.

## Affected installations {#affected-installations}

TYPO3 installations that used these methods directly in custom code are
affected. However, this is highly unlikely as they were intended for internal
testing only.

## Migration {#migration}

Instead of modifying configuration after instantiation using the removed
`setConfiguration()` method, merge configuration arrays before creating
the `CacheHashConfiguration` instance, then pass it to the
`CacheHashCalculator` constructor.

Example:

```php
// Before (removed approach):
$subject = new CacheHashCalculator(
    new CacheHashConfiguration($baseConfiguration),
    $hashService
);
$subject->setConfiguration([
    'cachedParametersWhiteList' => ['whitep1', 'whitep2'],
]);

// After (correct approach):
$configuration = new CacheHashConfiguration(
    array_merge($baseConfiguration, [
        'cachedParametersWhiteList' => ['whitep1', 'whitep2'],
    ])
);
$subject = new CacheHashCalculator($configuration, $hashService);
```