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,88 @@
+..  include:: /Includes.rst.txt
+
+..  _feature-107436-1736639846:
+
+============================================================
+Feature: #107436 - Symfony Translation Component integration
+============================================================
+
+See :issue:`107436`
+
+Description
+===========
+
+TYPO3 now utilizes the Symfony Translation component for reading localization
+label files such as XLIFF and PO, instead of its custom localization parsers.
+
+The migration brings several improvements:
+
+*   Standardized file parsing using Symfony's translation loaders
+*   Enhanced API for accessing translation catalogues
+*   Support for custom translation loaders following Symfony standards
+
+The new system maintains backward compatibility while providing a modern
+foundation for future improvements with translatable labels.
+
+In addition, all label-related configuration options have been streamlined
+under the :php:`$GLOBALS['TYPO3_CONF_VARS']['LANG']` namespace.
+
+The following new configuration options have been introduced:
+
+:php:`$GLOBALS['TYPO3_CONF_VARS']['LANG']['loader']`
+    Configure custom translation loaders.
+
+:php:`$GLOBALS['TYPO3_CONF_VARS']['LANG']['requireApprovedLocalizations']`
+    Moved from `SYS.lang`.
+
+:php:`$GLOBALS['TYPO3_CONF_VARS']['LANG']['format']`
+    Moved from `SYS.lang`.
+
+:php:`$GLOBALS['TYPO3_CONF_VARS']['LANG']['availableLocales']`
+    Moved from `EXTCONF.lang`.
+
+:php:`$GLOBALS['TYPO3_CONF_VARS']['LANG']['resourceOverrides']`
+    Moved from `SYS.locallangXMLOverride`.
+
+Custom translation loaders
+==========================
+
+Extension developers can now implement custom translation loaders by
+implementing Symfony's translation loader interfaces:
+
+..  code-block:: php
+    :caption: Example custom loader
+
+    use Symfony\Component\Translation\Loader\LoaderInterface;
+    use Symfony\Component\Translation\MessageCatalogue;
+
+    class CustomLoader implements LoaderInterface
+    {
+        public function load(mixed $resource, string $locale, string $domain = 'messages'): MessageCatalogue
+        {
+            // Custom loading logic
+            $catalogue = new MessageCatalogue($locale);
+            // ... populate catalogue
+            return $catalogue;
+        }
+    }
+
+Register custom loaders via configuration:
+
+..  code-block:: php
+    :caption: Register custom loader in configuration
+
+    $GLOBALS['TYPO3_CONF_VARS']['LANG']['loader']['fileEnding']
+        = \MyVendor\MyExtension\Translation\CustomLoader::class;
+
+Impact
+======
+
+All previous configuration options have been moved to the new
+:php:`$GLOBALS['TYPO3_CONF_VARS']['LANG']` namespace. These are automatically
+migrated to the new location when accessing the install tool.
+
+Please note: This functionality only affects the internal handling of
+translation files ("locallang" files). The public API of the localization
+system remains unchanged.
+
+..  index:: PHP-API, Backend, ext:core