TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,52 @@
+.. include:: /Includes.rst.txt
+
+.. _breaking-102835-1705314374:
+
+===============================================================
+Breaking: #102835 - Strict typing in final TypoLinkCodecService
+===============================================================
+
+See :issue:`102835`
+
+Description
+===========
+
+The :php:`\TYPO3\CMS\Core\LinkHandling\TypoLinkCodecService`, used to encode
+and decode TypoLinks, has been declared `readonly` and set `final`.
+Additionally, the class does now use strict typing and the :php:`decode()`
+method's first parameter :php:`$typoLink` is now a type hinted :php:`string`.
+
+This has been done in combination with the introduction of the two new PSR-14
+events :php:`BeforeTypoLinkEncodedEvent` and :php:`AfterTypoLinkDecodedEvent`,
+which allow to fully influence the encode and decode functionality, making
+any cross classing superfluous.
+
+Impact
+======
+
+Extending / cross classing :php:`TypoLinkCodecService` does no longer work
+and will lead to PHP errors.
+
+Calling :php:`decode()` with the first parameter :php:`$typolink` being not
+a :php:`string` will lead to a PHP TypeError.
+
+
+Affected installations
+======================
+
+All installations extending / cross classing :php:`TypoLinkCodecService` or
+calling :php:`decode()` with the first parameter :php:`$typolink` not being
+a :php:`string`.
+
+
+Migration
+=========
+
+Instead of extending / cross classing :php:`TypoLinkCodecService` use the
+:doc:`new PSR-14 events <../13.0/Feature-102835-AddPSR-14EventsToManipulateTypoLinkCodecService>`
+to modify the functionality.
+
+Ensure to always provide a :php:`string` as first parameter :php:`$typolink`,
+when calling :php:`decode()` in your extension code.
+
+.. index:: PHP-API, NotScanned, ext:core