[8.x] Add Cookie::queueForget() method

src/Illuminate/Cookie/CookieJar.php

@@ -153,6 +153,19 @@ public function queue(...$parameters)
         $this->queued[$cookie->getName()][$cookie->getPath()] = $cookie;
     }
 
+    /**
+     * Queue a cookie to expire with the next response.
+     *
+     * @param  string  $name
+     * @param  string|null  $path
+     * @param  string|null  $domain
+     * @return void
+     */
+    public function queueForget($name, $path = null, $domain = null)
+    {
+        $this->queue($this->forget($name, $path, $domain));
+    }
+
     /**
      * Remove a cookie from the queue.
      *

tests/Cookie/CookieTest.php

@@ -118,6 +118,22 @@ public function testHasQueuedWithPath(): void
         $this->assertFalse($cookieJar->hasQueued('foo', '/wrongPath'));
     }
 
+    public function testQueueForget()
+    {
+        $cookieJar = $this->getCreator();
+        $this->assertCount(0, $cookieJar->getQueuedCookies());
+
+        $cookieJar->queueForget('foobar', '/path', '/domain');
+
+        $cookie = $cookieJar->queued('foobar');
+        $this->assertEquals('foobar', $cookie->getName());
+        $this->assertEquals(null, $cookie->getValue());
+        $this->assertEquals('/path', $cookie->getPath());
+        $this->assertEquals('/domain', $cookie->getDomain());
+        $this->assertTrue($cookie->getExpiresTime() < time());
+        $this->assertCount(1, $cookieJar->getQueuedCookies());
+    }
+
     public function testUnqueue()
     {
         $cookie = $this->getCreator();