77 lines
2.1 KiB
ReStructuredText
77 lines
2.1 KiB
ReStructuredText
.. 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
|