Accept all eight rounding modes of round() on PHP 8.4

PHP 8.4 added four rounding modes, available as RoundingMode cases or as
their int values 5-8, and throws ValueError for any other int. The signature
still allowed only 1|2|3|4 besides RoundingMode, so round($f, 0, 5) was
reported.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Dhb4ssXuKVWcVBcNFpsdn7

Author: ondrejmirtes

resources/functionMap_php84delta.php

@@ -20,9 +20,11 @@
 		'http_clear_last_response_headers' => ['void'],
 		'mb_lcfirst' => ['string', 'string'=>'string', 'encoding='=>'string'],
 		'mb_ucfirst' => ['string', 'string'=>'string', 'encoding='=>'string'],
+		'round' => ['float', 'number'=>'float', 'precision='=>'int', 'mode='=>'int<1, 8>|RoundingMode'],
 		'simplexml_import_dom' => ['SimpleXMLElement|null', 'node'=>'object', 'class_name='=>'string'],
 	],
 	'old' => [
+		'round' => ['float', 'number'=>'float', 'precision='=>'int', 'mode='=>'1|2|3|4'],
 		'simplexml_import_dom' => ['SimpleXMLElement|null', 'node'=>'DOMNode', 'class_name='=>'string'],
 	]
 ];

tests/PHPStan/Rules/Functions/CallToFunctionParametersRuleTest.php

@@ -3151,4 +3151,19 @@ public function testLevenshteinArgumentsCount(): void
 		$this->analyse([__DIR__ . '/data/levenshtein-arguments-count.php'], []);
 	}
 
+	#[RequiresPhp('>= 8.4.0')]
+	public function testRoundModePhp84(): void
+	{
+		$this->analyse([__DIR__ . '/data/round-mode-php84.php'], [
+			[
+				'Parameter #3 $mode of function round expects int<1, 8>|RoundingMode, 9 given.',
+				11,
+			],
+			[
+				'Parameter #3 $mode of function round expects int<1, 8>|RoundingMode, 0 given.',
+				12,
+			],
+		]);
+	}
+
 }

tests/PHPStan/Rules/Functions/data/round-mode-php84.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace RoundModePhp84;
+
+function doFoo(float $f): void
+{
+	$a = round($f, 0, PHP_ROUND_HALF_UP);
+	$a = round($f, 0, 5);
+	$a = round($f, 0, 8);
+	$a = round($f, 0, \RoundingMode::HalfEven);
+	$a = round($f, 0, 9);
+	$a = round($f, 0, 0);
+}