---
title: "Breaking: #88687 - Configure extbase request handlers via PHP"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:breaking-88687"
source: "Changelog/10.0/Breaking-88687-ConfigureExtbaseRequestHandlersViaPHP.rst"
modified: "2026-09-14T09:47:36+00:00"
---

# Breaking: #88687 - Configure extbase request handlers via PHP

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

## Description

The configuration of extbase request handlers is no longer possible via typoscript.
All typoscript concerning the configuration of request handlers needs to be converted to php, residing
in `EXT:Configuration/Extbase/RequestHandlers.php`.

## Impact

Unless converted to php, the configuration in typoscript does no longer have any effect and therefore the registration
of request handlers will no longer work.

## Affected Installations

All installations that configure request handlers via typoscript.

## Migration

Every extension that used typoscript for such configuration must provide a php configuration class called:
`EXT:Configuration/Extbase/RequestHandlers.php`

The migration is best described by an example:

```typoscript
config.tx_extbase {
    mvc {
        requestHandlers {
            Vendor\Extension\Mvc\Web\FrontendRequestHandler = Vendor\Extension\Mvc\Web\FrontendRequestHandler
        }
    }
}
```

This configuration will look like this, defined in php:

```php
<?php
declare(strict_types = 1);

return [
    \Vendor\Extension\Mvc\Web\FrontendRequestHandler::class,
];
```

> [!WARNING]
> With typoscript it was possible to override request handlers, registered by extensions loaded before the current one.
> This also included core extensions. This approach has been bad practice because suitable request handlers are chosen
> by their ability to handle a request and their priority. The evaluation of priorities could have been bypassed by
> overriding keys of the configuration. This is no longer possible as request handler configuration files can only
> add possible request handlers. Hence the omitted keys in the configuration array.