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,85 @@
+..  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