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,55 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-94414:
+
+=====================================================
+Deprecation: #94414 - LanguageService container entry
+=====================================================
+
+See :issue:`94414`
+
+Description
+===========
+
+Instances of :php:`TYPO3\CMS\Core\Localization\LanguageService` require
+custom initialization with a language key and additionally depend on Core services.
+:php:`TYPO3\CMS\Core\Localization\LanguageServiceFactory` has therefore
+previously been introduced in order to manage this initialization.
+This replaced prior used instantiation via
+:php:`TYPO3\CMS\Core\Localization\LanguageService::create()` or
+:php:`GeneralUtility::makeInstance(LanguageService::class)`.
+
+
+Impact
+======
+
+Injecting :php:`TYPO3\CMS\Core\Localization\LanguageService` or creating
+instances via :php:`GeneralUtility::makeInstance(LanguageService::class)`,
+:php:`LanguageService::create()`, :php:`LanguageService::createFromUserPreferences()`
+or :php:`LanguageService::createFromSiteLanguage()` will trigger a
+PHP :php:`E_USER_DEPRECATED` error.
+
+
+Affected Installations
+======================
+
+Extensions injecting :php:`TYPO3\CMS\Core\Localization\LanguageService`
+or creating custom instances via :php:`GeneralUtility::makeInstance(LanguageService::class)`
+or :php:`TYPO3\CMS\Core\Localization\LanguageService::create()`.
+
+This is relatively unlikely since most usages are bootstrap related and
+extensions usually access the prepared LanguageService via :php:`GLOBALS['LANG']`
+in normal cases.
+
+Usages of :php:`LanguageService::create()`, :php:`LanguageService::createFromUserPreferences()`
+and :php:`LanguageService::createFromSiteLanguage()` are be found by the extension scanner
+as strong match.
+
+
+Migration
+=========
+
+The factory :php:`TYPO3\CMS\Core\Localization\LanguageServiceFactory`
+should be injected and used instead.
+
+.. index:: Backend, PHP-API, PartiallyScanned, ext:core