Deprecation: #108761 - BackendUtility TSconfig-related methods 

See forge#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. 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 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 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 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);
Copied!

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);
Copied!