Review main Merged Breaking

94910[!!!][FEATURE] Register file renderers as tagged services

Benni Mack CR +2 V +2 Hard +614 −362 updated 07/24/26, 16:55

Commit message

File renderers are now registered as tagged services via the new
PHP attribute #[AsFileRenderer] (or the service tag
"fal.file_renderer") instead of the programmatic registration
through RendererRegistry->registerRendererClass() in
ext_localconf.php. The renderer priority is defined at
registration time via the attribute, renderers with a higher
priority are asked first whether they can render a given file.

The registration is resolved once at container compile time
instead of executing registration code on every request: loading
and validating the renderer classes per request as well as
instantiating and sorting them by priority at runtime is gone,
the compiled container provides a pre-sorted lazy iterator.
Renderers become proper services with constructor injection,
their order no longer depends on the ext_localconf.php loading
order, and the new FileRendererPass validates at compile time
that every tagged service implements FileRendererInterface,
failing the container build instead of erroring at render time.

This comes with the following breaking changes:

* RendererRegistry->registerRendererClass() is now a no-op
  and will be removed in TYPO3 v16.0.
* FileRendererInterface does not extend SingletonInterface
  anymore, renderers are shared services managed by the DI
  container.
* getPriority() has been removed from FileRendererInterface,
  the remaining methods are now strictly typed.
* RendererRegistry is marked @internal, its remaining public
  API is getRenderer(), getRendererInstances() is protected
  and the priority sorting is delegated to the container.

Review

  • Code review CR +2 Done
    • Stefan Bürk +2
    • Oli Bartsch +1
  • Verified V +2 Done
    • Stefan Bürk +2
    • Oli Bartsch +1
    • core-ci +1 CI

Issues 1

Files 26

Show 6 more files

Review log 913

  1. Benni Mack uploaded patch set 1 07/23/26, 15:03

  2. core-ci voted on patch set 1 V +1 07/23/26, 15:11 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/105258

  3. Benni Mack uploaded patch set 2 V +1 07/24/26, 07:35

  4. core-ci voted on patch set 2 V +1 07/24/26, 07:43 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/105299

  5. Oli Bartsch uploaded patch set 3 V +1 07/24/26, 08:23

  6. core-ci voted on patch set 3 V +1 07/24/26, 08:31 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/105302

  7. Benni Mack marked it ready for review 07/24/26, 14:22

  8. Benni Mack uploaded patch set 4 V +1 07/24/26, 14:24

  9. Benni Mack marked it ready for review 07/24/26, 14:24

  10. core-ci voted on patch set 4 V +1 07/24/26, 14:33 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/105327

  11. Oli Bartsch voted on patch set 4 CR +1 V +1 07/24/26, 16:03

  12. Stefan Bürk voted on patch set 4 CR +2 V +2 07/24/26, 16:55

  13. Stefan Bürk merged patch set 5 07/24/26, 16:55