Breaking: #106405 - TypolinkBuilder signature changes

Description

To enable dependency injection for TypolinkBuilder classes, several breaking changes were introduced to the TypolinkBuilder architecture.

The following breaking changes have been made:

• The constructor of \TYPO3\CMS\Frontend\Typolink\AbstractTypolinkBuilder has been removed. Extending classes can no longer rely on receiving ContentObjectRenderer and TypoScriptFrontendController through the constructor.
• All concrete TypolinkBuilder implementations now implement the new \TYPO3\CMS\Frontend\Typolink\TypolinkBuilderInterface and use dependency injection via their constructors instead of extending AbstractTypolinkBuilder with constructor arguments.
• The method signature of the main link building method has changed from build(array &$linkDetails, string $linkText, string $target, array $conf) to buildLink(array $linkDetails, array $configuration, ServerRequestInterface $request, string $linkText = '').

Impact

Custom TypolinkBuilder implementations extending AbstractTypolinkBuilder will fail with fatal errors due to the removed constructor and changed method signatures.

Extensions that instantiate TypolinkBuilder classes directly will also fail, as the constructor signatures have fundamentally changed to use dependency injection.

Affected installations

TYPO3 installations with extensions that:

• Create custom TypolinkBuilder classes extending AbstractTypolinkBuilder
• Directly instantiate TypolinkBuilder classes in PHP code
• Override or extend the build() method of TypolinkBuilder classes

Migration

For custom TypolinkBuilder implementations:

1. Implement \TYPO3\CMS\Frontend\Typolink\TypolinkBuilderInterface
2. Use dependency injection in the constructor for required services
3. Replace the build() method with buildLink()

Note: Classes implementing TypolinkBuilderInterface are automatically configured as public services in the DI container - no manual configuration is required.

Example migration:

use TYPO3\CMS\Frontend\Typolink\AbstractTypolinkBuilder;

class MyCustomLinkBuilder extends AbstractTypolinkBuilder
{
    public function build(array &$linkDetails, string $linkText, string $target, array $conf): LinkResultInterface
    {
        // Custom link building logic
        return new LinkResult('news', $linkText);
    }
}

use Psr\Http\Message\ServerRequestInterface;
use TYPO3\CMS\Frontend\Typolink\TypolinkBuilderInterface;

class MyCustomLinkBuilder implements TypolinkBuilderInterface
{
    public function __construct(
        // Inject required dependencies
    ) {}

    public function buildLink(array $linkDetails, array $configuration, ServerRequestInterface $request, string $linkText = ''): LinkResultInterface
    {
        // Custom link building logic - access ContentObjectRenderer via:
        $contentObjectRenderer = $request->getAttribute('currentContentObject');
        return new LinkResult('news', $linkText);
    }
}

For code that instantiates TypolinkBuilder classes directly:

It is strongly recommended to use the \TYPO3\CMS\Frontend\Typolink\LinkFactory instead of instantiating TypolinkBuilder classes directly. The LinkFactory handles the proper instantiation and dependency injection automatically.