[12.x] Handle Null Check in Str::contains (#55991)

* [12.x] Handle Null Check in Str::contains

This PR adds a null check to the $haystack parameter. Null values for this parameter have been deprecated.

* [12.x] Micro-optimize Str::startsWith and Str::endsWith

Return earlier if $haystack is null

Author: Jellyfrog

src/Illuminate/Support/Str.php

@@ -297,6 +297,10 @@ public static function chopEnd($subject, $needle)
      */
     public static function contains($haystack, $needles, $ignoreCase = false)
     {
+        if (is_null($haystack)) {
+            return false;
+        }
+
         if ($ignoreCase) {
             $haystack = mb_strtolower($haystack);
         }
@@ -384,14 +388,14 @@ public static function deduplicate(string $string, string $character = ' ')
      */
     public static function endsWith($haystack, $needles)
     {
-        if (! is_iterable($needles)) {
-            $needles = (array) $needles;
-        }
-
         if (is_null($haystack)) {
             return false;
         }
 
+        if (! is_iterable($needles)) {
+            $needles = (array) $needles;
+        }
+
         foreach ($needles as $needle) {
             if ((string) $needle !== '' && str_ends_with($haystack, $needle)) {
                 return true;
@@ -1638,14 +1642,14 @@ public static function squish($value)
      */
     public static function startsWith($haystack, $needles)
     {
-        if (! is_iterable($needles)) {
-            $needles = [$needles];
-        }
-
         if (is_null($haystack)) {
             return false;
         }
 
+        if (! is_iterable($needles)) {
+            $needles = [$needles];
+        }
+
         foreach ($needles as $needle) {
             if ((string) $needle !== '' && str_starts_with($haystack, $needle)) {
                 return true;