bug #467 Update nullable types for PHP 8.4 (mbeccati)

This PR was squashed before being merged into the 1.x branch.

Discussion
----------

Update nullable types for PHP 8.4

The PR is meant to fix the deprecation notices raised since php/php-src@330cc5c

I had tried to update the php-cs-fixer rule, but running the fixer is re-formatting all the method bodies and I couldn't figure out how to cleanly get the desired result, so I used a trusted editor and some preg-fu to get the desired result.

Commits
-------

aaaa1c9 Update nullable types for PHP 8.4

Author: nicolas-grekas

.git-blame-ignore-revs

@@ -0,0 +1 @@
+a7548a261ad4bcdb675adceb6604cf1681b1f6e2

src/Intl/Icu/DateFormat/Hour1200Transformer.php

@@ -28,7 +28,7 @@ public function format(\DateTime $dateTime, int $length): string
         return $this->padLeft($hourOfDay, $length);
     }
 
-    public function normalizeHour(int $hour, string $marker = null): int
+    public function normalizeHour(int $hour, ?string $marker = null): int
     {
         if ('PM' === $marker) {
             $hour += 12;

src/Intl/Icu/DateFormat/Hour1201Transformer.php

@@ -25,7 +25,7 @@ public function format(\DateTime $dateTime, int $length): string
         return $this->padLeft($dateTime->format('g'), $length);
     }
 
-    public function normalizeHour(int $hour, string $marker = null): int
+    public function normalizeHour(int $hour, ?string $marker = null): int
     {
         if ('PM' !== $marker && 12 === $hour) {
             $hour = 0;

src/Intl/Icu/DateFormat/Hour2400Transformer.php

@@ -25,7 +25,7 @@ public function format(\DateTime $dateTime, int $length): string
         return $this->padLeft($dateTime->format('G'), $length);
     }
 
-    public function normalizeHour(int $hour, string $marker = null): int
+    public function normalizeHour(int $hour, ?string $marker = null): int
     {
         if ('AM' === $marker) {
             $hour = 0;

src/Intl/Icu/DateFormat/Hour2401Transformer.php

@@ -28,7 +28,7 @@ public function format(\DateTime $dateTime, int $length): string
         return $this->padLeft($hourOfDay, $length);
     }
 
-    public function normalizeHour(int $hour, string $marker = null): int
+    public function normalizeHour(int $hour, ?string $marker = null): int
     {
         if ((null === $marker && 24 === $hour) || 'AM' === $marker) {
             $hour = 0;

src/Intl/Icu/DateFormat/HourTransformer.php

@@ -28,5 +28,5 @@ abstract class HourTransformer extends Transformer
      *
      * @return int The normalized hour value
      */
-    abstract public function normalizeHour(int $hour, string $marker = null): int;
+    abstract public function normalizeHour(int $hour, ?string $marker = null): int;
 }

src/Intl/Icu/IntlDateFormatter.php

@@ -193,7 +193,7 @@ public function __construct(?string $locale, ?int $dateType, ?int $timeType, $ti
      * @throws MethodArgumentValueNotImplementedException When $locale different than "en" or null is passed
      * @throws MethodArgumentValueNotImplementedException When $calendar different than GREGORIAN is passed
      */
-    public static function create(?string $locale, ?int $dateType, ?int $timeType, $timezone = null, int $calendar = null, ?string $pattern = '')
+    public static function create(?string $locale, ?int $dateType, ?int $timeType, $timezone = null, ?int $calendar = null, ?string $pattern = '')
     {
         return new static($locale, $dateType, $timeType, $timezone, $calendar, $pattern);
     }
@@ -276,7 +276,7 @@ public function format($datetime)
      *
      * @throws MethodNotImplementedException
      */
-    public static function formatObject($datetime, $format = null, string $locale = null)
+    public static function formatObject($datetime, $format = null, ?string $locale = null)
     {
         throw new MethodNotImplementedException(__METHOD__);
     }

src/Intl/Icu/Locale.php

@@ -147,7 +147,7 @@ public static function getDefault()
      *
      * @throws MethodNotImplementedException
      */
-    public static function getDisplayLanguage(string $locale, string $displayLocale = null)
+    public static function getDisplayLanguage(string $locale, ?string $displayLocale = null)
     {
         throw new MethodNotImplementedException(__METHOD__);
     }
@@ -161,7 +161,7 @@ public static function getDisplayLanguage(string $locale, string $displayLocale
      *
      * @throws MethodNotImplementedException
      */
-    public static function getDisplayName(string $locale, string $displayLocale = null)
+    public static function getDisplayName(string $locale, ?string $displayLocale = null)
     {
         throw new MethodNotImplementedException(__METHOD__);
     }
@@ -175,7 +175,7 @@ public static function getDisplayName(string $locale, string $displayLocale = nu
      *
      * @throws MethodNotImplementedException
      */
-    public static function getDisplayRegion(string $locale, string $displayLocale = null)
+    public static function getDisplayRegion(string $locale, ?string $displayLocale = null)
     {
         throw new MethodNotImplementedException(__METHOD__);
     }
@@ -189,7 +189,7 @@ public static function getDisplayRegion(string $locale, string $displayLocale =
      *
      * @throws MethodNotImplementedException
      */
-    public static function getDisplayScript(string $locale, string $displayLocale = null)
+    public static function getDisplayScript(string $locale, ?string $displayLocale = null)
     {
         throw new MethodNotImplementedException(__METHOD__);
     }
@@ -203,7 +203,7 @@ public static function getDisplayScript(string $locale, string $displayLocale =
      *
      * @throws MethodNotImplementedException
      */
-    public static function getDisplayVariant(string $locale, string $displayLocale = null)
+    public static function getDisplayVariant(string $locale, ?string $displayLocale = null)
     {
         throw new MethodNotImplementedException(__METHOD__);
     }
@@ -271,7 +271,7 @@ public static function getScript(string $locale)
      *
      * @throws MethodNotImplementedException
      */
-    public static function lookup(array $languageTag, string $locale, bool $canonicalize = false, string $defaultLocale = null)
+    public static function lookup(array $languageTag, string $locale, bool $canonicalize = false, ?string $defaultLocale = null)
     {
         throw new MethodNotImplementedException(__METHOD__);
     }

src/Intl/Icu/NumberFormatter.php

@@ -254,7 +254,7 @@ abstract class NumberFormatter
      * @throws MethodArgumentValueNotImplementedException When the $style is not supported
      * @throws MethodArgumentNotImplementedException      When the pattern value is different than null
      */
-    public function __construct(?string $locale = 'en', int $style = null, string $pattern = null)
+    public function __construct(?string $locale = 'en', ?int $style = null, ?string $pattern = null)
     {
         if ('en' !== $locale && null !== $locale) {
             throw new MethodArgumentValueNotImplementedException(__METHOD__, 'locale', $locale, 'Only the locale "en" is supported');
@@ -293,7 +293,7 @@ public function __construct(?string $locale = 'en', int $style = null, string $p
      * @throws MethodArgumentValueNotImplementedException When the $style is not supported
      * @throws MethodArgumentNotImplementedException      When the pattern value is different than null
      */
-    public static function create(?string $locale = 'en', int $style = null, string $pattern = null)
+    public static function create(?string $locale = 'en', ?int $style = null, ?string $pattern = null)
     {
         return new static($locale, $style, $pattern);
     }

src/Mbstring/Mbstring.php

@@ -827,7 +827,7 @@ public static function mb_ord($s, $encoding = null)
         return $code;
     }
 
-    public static function mb_str_pad(string $string, int $length, string $pad_string = ' ', int $pad_type = \STR_PAD_RIGHT, string $encoding = null): string
+    public static function mb_str_pad(string $string, int $length, string $pad_string = ' ', int $pad_type = \STR_PAD_RIGHT, ?string $encoding = null): string
     {
         if (!\in_array($pad_type, [\STR_PAD_RIGHT, \STR_PAD_LEFT, \STR_PAD_BOTH], true)) {
             throw new \ValueError('mb_str_pad(): Argument #4 ($pad_type) must be STR_PAD_LEFT, STR_PAD_RIGHT, or STR_PAD_BOTH');