[8.x] Added the whereInstanceOfAny() method for collections (#36328)

* Added the whereInstanceOfAny() method for collections.

* Moved whereInstanceOfAny logic into whereInstanceOf method.

* Added tests for using whereInstanceOf with an array.

Author: ash-jc-allen

src/Illuminate/Collections/Enumerable.php

@@ -415,9 +415,9 @@ public function whereNotIn($key, $values, $strict = false);
     public function whereNotInStrict($key, $values);
 
     /**
-     * Filter the items, removing any items that don't match the given type.
+     * Filter the items, removing any items that don't match the given type(s).
      *
-     * @param  string  $type
+     * @param  string|string[]  $type
      * @return static
      */
     public function whereInstanceOf($type);

src/Illuminate/Collections/Traits/EnumeratesValues.php

@@ -669,14 +669,24 @@ public function whereNotInStrict($key, $values)
     }
 
     /**
-     * Filter the items, removing any items that don't match the given type.
+     * Filter the items, removing any items that don't match the given type(s).
      *
-     * @param  string  $type
+     * @param  string|string[]  $type
      * @return static
      */
     public function whereInstanceOf($type)
     {
         return $this->filter(function ($value) use ($type) {
+            if (is_array($type)) {
+                foreach ($type as $classType) {
+                    if ($value instanceof $classType) {
+                        return true;
+                    }
+                }
+
+                return false;
+            }
+
             return $value instanceof $type;
         });
     }

tests/Support/SupportCollectionTest.php

@@ -766,8 +766,10 @@ public function testWhereStrict($collection)
      */
     public function testWhereInstanceOf($collection)
     {
-        $c = new $collection([new stdClass, new stdClass, new $collection, new stdClass]);
+        $c = new $collection([new stdClass, new stdClass, new $collection, new stdClass, new Str]);
         $this->assertCount(3, $c->whereInstanceOf(stdClass::class));
+
+        $this->assertCount(4, $c->whereInstanceOf([stdClass::class, Str::class]));
     }
 
     /**