Added array_intersect_key to the Collection object - 19682 (#19683)

* Added array_intersect_key to the Collection object - 19680

* style ci

Author: VinceG

src/Illuminate/Support/Collection.php

@@ -665,6 +665,17 @@ public function intersect($items)
         return new static(array_intersect($this->items, $this->getArrayableItems($items)));
     }
 
+    /**
+     * Intersect the collection with the given items by key.
+     *
+     * @param  mixed  $items
+     * @return static
+     */
+    public function intersectKey($items)
+    {
+        return new static(array_intersect_key($this->items, $this->getArrayableItems($items)));
+    }
+
     /**
      * Determine if the collection is empty or not.
      *

tests/Support/SupportCollectionTest.php

@@ -590,6 +590,18 @@ public function testIntersectCollection()
         $this->assertEquals(['first_word' => 'Hello'], $c->intersect(new Collection(['first_world' => 'Hello', 'last_word' => 'World']))->all());
     }
 
+    public function testIntersectKeyNull()
+    {
+        $c = new Collection(['id' => 1, 'first_word' => 'Hello']);
+        $this->assertEquals([], $c->intersectKey(null)->all());
+    }
+
+    public function testIntersectKeyCollection()
+    {
+        $c = new Collection(['id' => 1, 'first_word' => 'Hello']);
+        $this->assertEquals(['first_word' => 'Hello'], $c->intersectKey(new Collection(['first_word' => 'Hello', 'last_word' => 'World']))->all());
+    }
+
     public function testUnique()
     {
         $c = new Collection(['Hello', 'World', 'World']);