[12.x] Add CacheFlushed Event (#55142)

* [12.x] Fix: Added CacheFlushed Event

* [12.x] StyleCLI Resolved

* [12.x] StyleCLI Resolved

* [12.x] CacheFlushing Event added

* [12.x] Created New Class for Key free CacheEvent for Flush

* [12.x] Deleted New CacheFlush Event

* [12.x] PR comments resolved

Author: tech-wolf-tw

src/Illuminate/Cache/Events/CacheFlushed.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Illuminate\Cache\Events;
+
+class CacheFlushed
+{
+    /**
+     * The name of the cache store.
+     *
+     * @var string|null
+     */
+    public $storeName;
+
+    /**
+     * Create a new event instance.
+     *
+     * @param  string|null  $storeName
+     * @return void
+     */
+    public function __construct($storeName)
+    {
+        $this->storeName = $storeName;
+    }
+}

src/Illuminate/Cache/Events/CacheFlushing.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Illuminate\Cache\Events;
+
+class CacheFlushing
+{
+    /**
+     * The name of the cache store.
+     *
+     * @var string|null
+     */
+    public $storeName;
+
+    /**
+     * Create a new event instance.
+     *
+     * @param  string|null  $storeName
+     * @return void
+     */
+    public function __construct($storeName)
+    {
+        $this->storeName = $storeName;
+    }
+}

src/Illuminate/Cache/Repository.php

@@ -6,6 +6,8 @@
 use BadMethodCallException;
 use Closure;
 use DateTimeInterface;
+use Illuminate\Cache\Events\CacheFlushed;
+use Illuminate\Cache\Events\CacheFlushing;
 use Illuminate\Cache\Events\CacheHit;
 use Illuminate\Cache\Events\CacheMissed;
 use Illuminate\Cache\Events\ForgettingKey;
@@ -576,7 +578,15 @@ public function deleteMultiple($keys): bool
      */
     public function clear(): bool
     {
-        return $this->store->flush();
+        $this->event(new CacheFlushing($this->getName()));
+
+        $result = $this->store->flush();
+
+        if ($result) {
+            $this->event(new CacheFlushed($this->getName()));
+        }
+
+        return $result;
     }
 
     /**

tests/Cache/CacheEventsTest.php

@@ -3,6 +3,8 @@
 namespace Illuminate\Tests\Cache;
 
 use Illuminate\Cache\ArrayStore;
+use Illuminate\Cache\Events\CacheFlushed;
+use Illuminate\Cache\Events\CacheFlushing;
 use Illuminate\Cache\Events\CacheHit;
 use Illuminate\Cache\Events\CacheMissed;
 use Illuminate\Cache\Events\ForgettingKey;
@@ -221,6 +223,44 @@ public function testForgetDoesTriggerFailedEventOnFailure()
         $this->assertFalse($repository->forget('baz'));
     }
 
+    public function testFlushTriggersEvents()
+    {
+        $dispatcher = $this->getDispatcher();
+        $repository = $this->getRepository($dispatcher);
+
+        $dispatcher->shouldReceive('dispatch')->once()->with(
+            $this->assertEventMatches(CacheFlushing::class, [
+                'storeName' => 'array',
+            ])
+        );
+
+        $dispatcher->shouldReceive('dispatch')->once()->with(
+            $this->assertEventMatches(CacheFlushed::class, [
+                'storeName' => 'array',
+            ])
+        );
+        $this->assertTrue($repository->clear());
+    }
+
+    public function testFlushFailureDoesNotDispatchEvent()
+    {
+        $dispatcher = $this->getDispatcher();
+
+        // Create a store that fails to flush
+        $failingStore = m::mock(Store::class);
+        $failingStore->shouldReceive('flush')->andReturn(false);
+
+        $repository = new Repository($failingStore, ['store' => 'array']);
+        $repository->setEventDispatcher($dispatcher);
+
+        $dispatcher->shouldReceive('dispatch')->once()->with(
+            $this->assertEventMatches(CacheFlushing::class, [
+                'storeName' => 'array',
+            ])
+        );
+        $this->assertFalse($repository->clear());
+    }
+
     protected function assertEventMatches($eventClass, $properties = [])
     {
         return m::on(function ($event) use ($eventClass, $properties) {

tests/Support/SupportFacadesEventTest.php

@@ -3,6 +3,8 @@
 namespace Illuminate\Tests\Support;
 
 use Illuminate\Cache\CacheManager;
+use Illuminate\Cache\Events\CacheFlushed;
+use Illuminate\Cache\Events\CacheFlushing;
 use Illuminate\Cache\Events\CacheMissed;
 use Illuminate\Cache\Events\RetrievingKey;
 use Illuminate\Config\Repository as ConfigRepository;
@@ -87,6 +89,17 @@ public function testFakeSwapsDispatchersInResolvedCacheRepositories()
         Event::assertDispatched(CacheMissed::class);
     }
 
+    public function testCacheFlushDispatchesEvent()
+    {
+        $arrayRepository = Cache::store('array');
+        Event::fake();
+
+        $arrayRepository->clear();
+
+        Event::assertDispatched(CacheFlushing::class);
+        Event::assertDispatched(CacheFlushed::class);
+    }
+
     protected function getCacheConfig()
     {
         return [