Deprecation: #108761 - BackendUtility TSconfig-related methods

[simonschaufi]

Deprecation: #108761 - BackendUtility TSconfig-related methods

https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/14.2/Deprecation-108761-BackendUtilityTSconfigMethods.html

Deprecation: #108761 - BackendUtility TSconfig-related methods

See 108761

Description

The following methods in \TYPO3\CMS\Backend\Utility\BackendUtility
have been deprecated:

• getTCEFORM_TSconfig()
• getTSCpidCached()
• getTSCpid()

A new method BackendUtility::getRealPageId() has been introduced that
returns the real page ID for a given record. Unlike the previous methods
that 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 null if the page cannot be determined.

Impact

Calling any of the deprecated methods will trigger 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 directly call any of the deprecated methods
are affected.

Migration

getTCEFORM_TSconfig()

This method has been moved to FormEngineUtility. If you need TSconfig
for TCEFORM, it is recommended to 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 getRealPageId() method returns only the real
page ID.

Before

// getTSCpidCached returned [$tscPid, $realPid]
[$tscPid, $realPid] = BackendUtility::getTSCpidCached($table, $uid, $pid);

// getTSCpid returned the same structure
[$tscPid, $realPid] = BackendUtility::getTSCpid($table, $uid, $pid);

After

// 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);

PHP-API, FullyScanned, ext:backend