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,44 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-103785-1714720280:
+
+========================================================================
+Deprecation: #103785 - Deprecate MathUtility::convertToPositiveInteger()
+========================================================================
+
+See :issue:`103785`
+
+Description
+===========
+
+TYPO3 has the method :php:`MathUtility::convertToPositiveInteger()` to ensure
+that an integer is always positive. However, the method is rather
+"heavy" as it calls :php:`MathUtility::forceIntegerInRange()` internally and
+therefore misuses a clamp mechanism to convert the integer to a positive number.
+
+Also, the method name doesn't reflect what the method actually does. Negative
+numbers are not converted to their positive counterpart, but are swapped with
+`0`. Due to the naming issue and the fact that the method can be replaced by a
+simple :php:`max()` call, the method is therefore deprecated.
+
+Impact
+======
+
+Calling :php:`MathUtility::convertToPositiveInteger()` will trigger a PHP
+deprecation warning.
+
+
+Affected installations
+======================
+
+All installations using :php:`MathUtility::convertToPositiveInteger()`.
+
+
+Migration
+=========
+
+To recover the original behavior of the deprecated method, its call can be
+replaced with :php:`max(0, $number)`. To actually convert negative numbers to
+their positive counterpart, call :php:`abs($number)`.
+
+.. index:: PHP-API, FullyScanned, ext:core