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,68 @@
+..  include:: /Includes.rst.txt
+
+..  _breaking-98070-1743452794:
+
+==========================================
+Breaking: #98070 - Remove eval method year
+==========================================
+
+See :issue:`98070`
+
+Description
+===========
+
+The eval method `year` was used to validate the value of a TCA field. Its
+implementation was never completed and simply cast the value to an integer.
+
+As there is no clear definition of what a valid year value should be, the
+method has been removed without substitution.
+
+Impact
+======
+
+The value `year` has been removed from the list of supported `eval` options.
+
+The TCA migration will trigger a deprecation log entry when building the final
+TCA.
+
+Affected installations
+======================
+
+TYPO3 installations using old extensions that define custom TCA configurations
+with this option set are affected.
+
+Migration
+=========
+
+Remove the `year` eval setting from your TCA configuration and use a TCA field
+type that better suits your needs.
+
+..  code-block:: php
+
+    // Use type "number" with an optional range restriction
+    'variant_a' => [
+        'label' => 'My year',
+        'config' => [
+            'type' => 'number',
+            'range' => [
+                'lower' => 1990,
+                'upper' => 2038,
+            ],
+            'default' => 0,
+        ],
+    ],
+
+    // Use a date field with an optional range restriction
+    'variant_b' => [
+        'label' => 'My year',
+        'config' => [
+            'type' => 'datetime',
+            'range' => [
+                'lower' => gmmktime(0, 0, 0, 1, 1, 1990),
+                'upper' => gmmktime(23, 59, 59, 12, 31, 2038),
+            ],
+            'nullable' => true,
+        ],
+    ],
+
+..  index:: Backend, TCA, NotScanned, ext:backend