Breaking: #110485 - Menu content object registration changed 

Description 

Menu content objects - the sub types of the HMENU content object, for example TMENU - are now registered as tagged services via dependency injection. This comes with the following breaking changes:

• The class \TYPO3\CMS\Frontend\ContentObject\Menu\MenuContentObjectFactory has been removed. It was marked @internal , but its method registerMenuType() was the only way to add or override a menu type and was therefore used from ext_localconf.php.
• The exception \TYPO3\CMS\Frontend\ContentObject\Menu\Exception\NoSuchMenuTypeException has been removed. An unregistered menu type is no longer signaled by an exception, the menu is simply not rendered - which is the behavior that was already visible from the outside, since all Core call sites caught the exception and continued silently.
• \TYPO3\CMS\Frontend\ContentObject\Menu\AbstractMenuContentObject now declares a constructor which requires the service locator of all registered menu content objects as the first argument. Subclasses which declare their own constructor must hand this argument to parent::__construct() .
• Menu content objects are never shared: every HMENU level is rendered by its own instance. Instantiating them through GeneralUtility::makeInstance() is not supported anymore, they have to be retrieved from the service locator.

The constructor argument of AbstractMenuContentObject is set by the dependency injection container for all services tagged as frontend.menucontentobject , together with shared: false . Registering a menu type therefore only requires the tag itself.

Impact 

Menu types registered via MenuContentObjectFactory->registerMenuType() in ext_localconf.php cause a fatal PHP error, since the class does not exist anymore.

Custom classes extending AbstractMenuContentObject with their own constructor cause a fatal PHP error as soon as they are instantiated, unless they pass the service locator on to parent::__construct() .

Affected installations 

All installations with custom extensions registering their own menu type, or overriding the TMENU implementation. Since the only menu type shipped by TYPO3 Core is TMENU , most installations are not affected. The extension scanner reports usages of MenuContentObjectFactory and registerMenuType() .

Migration 

Remove the registerMenuType() call from ext_localconf.php and register the menu content object as a tagged service instead. The identifier is the menu type as used in TypoScript and has to be written in upper case:

services:
  _defaults:
    autowire: true
    autoconfigure: true
    public: false

  My\Extension\ContentObject\Menu\FancyMenuContentObject:
    tags:
      - name: frontend.menucontentobject
        identifier: 'FANCYMENU'

The menu type can then be used in TypoScript as before:

page.10 = HMENU
page.10 {
    1 = FANCYMENU
    1 {
        NO = 1
    }
}

An existing menu type - including TMENU - is overridden by registering a custom class with the same identifier. As extensions are loaded after TYPO3 Core, the last registration for an identifier wins.

Custom classes extending AbstractMenuContentObject which declare their own constructor have to accept and pass on the service locator:

use Psr\Container\ContainerInterface;
use TYPO3\CMS\Frontend\ContentObject\Menu\AbstractMenuContentObject;

final class FancyMenuContentObject extends AbstractMenuContentObject
{
    public function __construct(
        ContainerInterface $menuContentObjectLocator,
        private readonly MyOwnDependency $myOwnDependency,
    ) {
        parent::__construct($menuContentObjectLocator);
    }
}

Code which created a menu content object through MenuContentObjectFactory->getMenuObjectByType() should inject the locator of all registered menu content objects instead:

services:
  My\Extension\DataProcessing\MyMenuProcessor:
    shared: false
    arguments:
      $menuContentObjectLocator: !tagged_locator { tag: 'frontend.menucontentobject', index_by: 'identifier' }

use Psr\Container\ContainerInterface;

final class MyMenuProcessor
{
    public function __construct(
        private readonly ContainerInterface $menuContentObjectLocator,
    ) {}

    public function process(): void
    {
        $menu = $this->menuContentObjectLocator->get('TMENU');
        // ...
    }
}