Fix PHPStan errors for GitHub Actions CI

- Add parameter validation in random_bytes() calls (src/Str.php)
- Replace @throws Random\RandomException with Exception for PHP 8.0/8.1 compatibility
- Remove unmatched ignored error from phpstan.neon

Author: parsilver

phpstan.neon

@@ -26,8 +26,3 @@ parameters:
     excludePaths:
         - vendor
         - tests
-
-    # Custom rules
-    ignoreErrors:
-        # Allow mixed types where necessary
-        - '#Parameter \#1 \$array of static method Farzai\\Support\\Arr::get\(\) expects array|ArrayAccess, mixed given#'

src/Str.php

@@ -244,7 +244,7 @@ public static function isStudlyCase(string $value): bool
      * @param  int  $length  The desired length of the random string
      * @return string A random string of the specified length
      *
-     * @throws \Random\RandomException If random_bytes() fails
+     * @throws \Exception If random_bytes() fails
      *
      * @example
      * Str::random(16); // Returns: 'a3K7mN9pQ1xY2zB5'
@@ -255,7 +255,7 @@ public static function random(int $length = 16): string
 
         while (static::length($string) < $length) {
             $remaining = $length - static::length($string);
-            $bytes = random_bytes($remaining);
+            $bytes = random_bytes(max(1, $remaining));
             $string .= substr(str_replace(['/', '+', '='], '', base64_encode($bytes)), 0, $remaining);
         }
 
@@ -268,14 +268,14 @@ public static function random(int $length = 16): string
      * @param  int  $length  The desired length of the random string
      * @return string A random ASCII string of the specified length
      *
-     * @throws \Random\RandomException If random_bytes() fails
+     * @throws \Exception If random_bytes() fails
      *
      * @example
      * Str::randomAscii(16); // Returns: 'a3K7mN9pQ1xY2zB5'
      */
     public static function randomAscii(int $length = 16): string
     {
-        return static::substr(str_replace(['/', '+', '='], '', base64_encode(random_bytes($length))), 0, $length);
+        return static::substr(str_replace(['/', '+', '='], '', base64_encode(random_bytes(max(1, $length)))), 0, $length);
     }
 
     /**
@@ -284,7 +284,7 @@ public static function randomAscii(int $length = 16): string
      * @param  int  $length  The desired length of the random string
      * @return string A random numeric string of the specified length
      *
-     * @throws \Random\RandomException If random_int() fails
+     * @throws \Exception If random_int() fails
      *
      * @example
      * Str::randomNumeric(6); // Returns: '472891'
@@ -308,7 +308,7 @@ public static function randomNumeric(int $length = 16): string
      * @param  int  $length  The desired length of the random string
      * @return string A random alphanumeric string of the specified length
      *
-     * @throws \Random\RandomException If random_int() fails
+     * @throws \Exception If random_int() fails
      *
      * @example
      * Str::randomAlphanumeric(12); // Returns: 'aB3xY9mK2nP7'
@@ -325,7 +325,7 @@ public static function randomAlphanumeric(int $length = 16): string
      * @param  string|null  $characters  The character set to use (defaults to alphanumeric)
      * @return string A random string of the specified length from the character set
      *
-     * @throws \Random\RandomException If random_int() fails
+     * @throws \Exception If random_int() fails
      *
      * @example
      * Str::randomString(8, 'ABCD123'); // Returns: 'A2B1C3D2'
@@ -350,7 +350,7 @@ public static function randomString(int $length = 16, ?string $characters = null
      * @param  int  $length  The desired length of the random string
      * @return string A random alphanumeric string of the specified length
      *
-     * @throws \Random\RandomException If random_int() fails
+     * @throws \Exception If random_int() fails
      *
      * @example
      * Str::randomStringWithNumeric(10); // Returns: 'aB3xY9mK2n'
@@ -369,7 +369,7 @@ public static function randomStringWithNumeric(int $length = 16): string
      * @param  int  $length  The desired length of the random string
      * @return string A random string with special characters
      *
-     * @throws \Random\RandomException If random_int() fails
+     * @throws \Exception If random_int() fails
      *
      * @example
      * Str::randomStringWithSpecialCharacter(12); // Returns: 'aB3!xY@9#mK2'