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,76 @@
+..  include:: /Includes.rst.txt
+
+..  _deprecation-108761-1769281290:
+
+==============================================================
+Deprecation: #108761 - BackendUtility TSconfig-related methods
+==============================================================
+
+See :issue:`108761`
+
+Description
+===========
+
+The following methods in :php:`\TYPO3\CMS\Backend\Utility\BackendUtility` have
+been deprecated:
+
+*   :php:`getTCEFORM_TSconfig()`
+*   :php:`getTSCpidCached()`
+*   :php:`getTSCpid()`
+
+A new method :php:`BackendUtility::getRealPageId()` has been introduced. It
+returns the real page ID of a given record. Unlike the previous methods which
+returned arrays with multiple values or used internal caching, this method
+provides a cleaner API that returns either the page ID as an integer or
+:php:`null` if the page cannot be determined.
+
+Impact
+======
+
+Calling any of the deprecated methods triggers a deprecation-level log entry.
+The methods will be removed in TYPO3 v15.0.
+
+The extension scanner reports usages as a **strong** match.
+
+Affected installations
+======================
+
+Instances or extensions that call any of the deprecated methods.
+
+Migration
+=========
+
+getTCEFORM_TSconfig()
+---------------------
+
+This method has been moved to :php:`FormEngineUtility`. If you need TSconfig
+for TCEFORM, it is recommended that you rely on FormEngine data providers
+instead.
+
+getTSCpidCached() and getTSCpid()
+---------------------------------
+
+These methods returned an array with two values: the TSconfig PID and the
+real PID. The new :php:`getRealPageId()` method returns only the real page ID.
+
+Before:
+
+..  code-block:: php
+
+    // getTSCpidCached returned [$tscPid, $realPid]
+    [$tscPid, $realPid] = BackendUtility::getTSCpidCached($table, $uid, $pid);
+
+    // getTSCpid returned the same structure
+    [$tscPid, $realPid] = BackendUtility::getTSCpid($table, $uid, $pid);
+
+After:
+
+..  code-block:: php
+
+    // getRealPageId() returns int|null
+    $pageId = BackendUtility::getRealPageId($table, $uid, $pid);
+
+    // If you need to ensure an integer (null becomes 0)
+    $pageId = (int)BackendUtility::getRealPageId($table, $uid, $pid);
+
+..  index:: PHP-API, FullyScanned, ext:backend