[5.7] Add missing() method to the Cache (#26351)

* [5.7] Added `missing()` method to the Cache\Repository and its Facade

* [5.7] Removed the `missing()` method from the `Cache\Repository` contract

src/Illuminate/Cache/Repository.php

@@ -70,6 +70,17 @@ public function has($key)
         return ! is_null($this->get($key));
     }
 
+    /**
+     * Determine if an item doesn't exist in the cache.
+     *
+     * @param  string  $key
+     * @return bool
+     */
+    public function missing($key)
+    {
+        return ! $this->has($key);
+    }
+
     /**
      * Retrieve an item from the cache by key.
      *

src/Illuminate/Support/Facades/Cache.php

@@ -5,6 +5,7 @@
 /**
  * @method static \Illuminate\Contracts\Cache\Repository  store(string|null $name = null)
  * @method static bool has(string $key)
+ * @method static bool missing(string $key)
  * @method static mixed get(string $key, mixed $default = null)
  * @method static mixed pull(string $key, mixed $default = null)
  * @method static void put(string $key, $value, \DateTimeInterface|\DateInterval|float|int $minutes)

tests/Cache/CacheRepositoryTest.php

@@ -71,6 +71,16 @@ public function testHasMethod()
         $this->assertFalse($repo->has('foo'));
     }
 
+    public function testMissingMethod()
+    {
+        $repo = $this->getRepository();
+        $repo->getStore()->shouldReceive('get')->once()->with('foo')->andReturn(null);
+        $repo->getStore()->shouldReceive('get')->once()->with('bar')->andReturn('bar');
+
+        $this->assertTrue($repo->missing('foo'));
+        $this->assertFalse($repo->missing('bar'));
+    }
+
     public function testRememberMethodCallsPutAndReturnsDefault()
     {
         $repo = $this->getRepository();