86 lines
2.9 KiB
ReStructuredText
86 lines
2.9 KiB
ReStructuredText
.. include:: /Includes.rst.txt
|
|
|
|
.. _deprecation-107562-1736193200:
|
|
|
|
=======================================================================
|
|
Deprecation: #107562 - IP Anonymization Task configuration via $GLOBALS
|
|
=======================================================================
|
|
|
|
See :issue:`107562`
|
|
|
|
Description
|
|
===========
|
|
|
|
The :php:`\TYPO3\CMS\Scheduler\Task\IpAnonymizationTask` has been migrated to
|
|
use TYPO3's native TCA-based task configuration system. As part of this
|
|
migration, the previous configuration method using
|
|
:php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['scheduler']['tasks'][IpAnonymizationTask::class]['options']['tables']`
|
|
has been deprecated and will be removed in TYPO3 v15.0.
|
|
|
|
Impact
|
|
======
|
|
|
|
Using the old configuration method will trigger a PHP deprecation warning.
|
|
The functionality continues to work for now, with the deprecated configuration
|
|
being merged with the new TCA-based configuration automatically.
|
|
|
|
Affected installations
|
|
======================
|
|
|
|
Any installation that configures custom tables for the
|
|
:php-short:`\TYPO3\CMS\Scheduler\Task\IpAnonymizationTask` using the deprecated
|
|
:php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']` configuration.
|
|
|
|
The extension scanner will report any usage as a **weak match**.
|
|
|
|
Migration
|
|
=========
|
|
|
|
Instead of configuring tables via :php:`$GLOBALS['TYPO3_CONF_VARS']`, tables
|
|
should now be configured in TCA using the :php:`taskOptions` configuration of
|
|
the corresponding record type within
|
|
:file:`Configuration/TCA/Overrides/`.
|
|
|
|
Before (deprecated):
|
|
|
|
.. code-block:: php
|
|
:caption: ext_localconf.php
|
|
|
|
use TYPO3\CMS\Scheduler\Task\IpAnonymizationTask;
|
|
|
|
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['scheduler']['tasks'][IpAnonymizationTask::class]['options']['tables']['tx_myextension_my_table'] = [
|
|
'dateField' => 'tstamp',
|
|
'ipField' => 'private_ip',
|
|
];
|
|
|
|
After (new method):
|
|
|
|
.. code-block:: php
|
|
:caption: Configuration/TCA/Overrides/scheduler_ip_anonymization.php
|
|
|
|
use TYPO3\CMS\Scheduler\Task\IpAnonymizationTask;
|
|
|
|
if (isset($GLOBALS['TCA']['tx_scheduler_task'])) {
|
|
$GLOBALS['TCA']['tx_scheduler_task']['types'][IpAnonymizationTask::class]['taskOptions']['tables'] ['tx_myextension_my_table'] = [
|
|
'dateField' => 'tstamp',
|
|
'ipField' => 'private_ip',
|
|
];
|
|
}
|
|
|
|
It is also possible to modify the tables added by TYPO3, for example changing
|
|
the :php:`dateField` of :sql:`sys_log`:
|
|
|
|
.. code-block:: php
|
|
|
|
use TYPO3\CMS\Scheduler\Task\IpAnonymizationTask;
|
|
|
|
if (isset($GLOBALS['TCA']['tx_scheduler_task'])) {
|
|
$GLOBALS['TCA']['tx_scheduler_task']['types'][IpAnonymizationTask::class]['taskOptions']['tables']['sys_log']['dateField']
|
|
= 'custom_date';
|
|
}
|
|
|
|
The new TCA-based configuration provides the same functionality while
|
|
integrating better with TYPO3's native scheduler task system and FormEngine.
|
|
|
|
.. index:: PHP-API, Scheduler, TCA, FullyScanned, ext:scheduler
|