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,67 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-95320:
+
+========================================================================
+Deprecation: #95320 - Various method arguments in Authentication objects
+========================================================================
+
+See :issue:`95320`
+
+Description
+===========
+
+The following methods of the classes
+:php:`TYPO3\CMS\Core\Authentication\AbstractUserAuthentication` and
+:php:`TYPO3\CMS\Core\Authentication\BackendUserAuthentication` have their
+first argument been marked as deprecated:
+
+*   :php:`AbstractUserAuthentication->writeUC()`
+*   :php:`AbstractUserAuthentication->unpack_uc()`
+*   :php:`BackendUserAuthentication->backendCheckLogin()`
+
+The following method has its third argument marked as deprecated:
+
+*   :php:`BackendUserAuthentication->isInWebMount()`
+
+
+Impact
+======
+
+Calling these methods with an explicit argument of the deprecated
+arguments given will trigger a PHP :php:`E_USER_DEPRECATED` error.
+
+
+Affected installations
+======================
+
+TYPO3 installations with custom extensions calling these methods
+with the deprecated arguments which is highly unlikely.
+
+
+Migration
+=========
+
+Call :php:`AbstractUserAuthentication->writeUC()` without a
+method argument. If you need to explicitly set a custom UC value
+which is not :php:`AbstractUserAuthentication->uc`, you can set this via
+:php:`AbstractUserAuthentication->uc = $myValue;` in the
+line before.
+
+Call :php:`AbstractUserAuthentication->unpack_uc()` without an
+method argument. If you need to explicitly set a custom UC value
+which is not :php:`AbstractUserAuthentication->uc`, you can set this via
+:php:`AbstractUserAuthentication->uc = $myValue;` in the
+line before.
+
+Call :php:`BackendUserAuthentication->backendCheckLogin()` without
+an argument but wrap this call in a :php:`try {} catch (\Throwable $e)` if
+you need the old behavior and want to avoid a deprecation
+message.
+
+Call :php:`BackendUserAuthentication->isInWebMount()` without the
+third argument and check for the return value of being :php:`null`
+which is the equivalent of the expected :php:`RuntimeException` being
+thrown when the third argument was set to :php:`true`.
+
+.. index:: Backend, Frontend, PHP-API, FullyScanned, ext:core