Finalised event docs

Author: Geolim4

docs/EVENTS.md

@@ -35,8 +35,8 @@ EventManager::getInstance()->unbindEventCallback('onCacheGetItem', 'myCallbackNa
 ```
 
 
-List of active events:
-
+## List of active events:
+### ItemPool Events
 - onCacheGetItem(*Callable* **$callback**)
     - **Callback arguments**
       - *ExtendedCacheItemPoolInterface* **$itemPool**
@@ -139,7 +139,40 @@ List of active events:
         - *ExtendedCacheItemPoolInterface::getItems()*
         - *ExtendedCacheItemPoolInterface::getItemsByTag()*
         - *ExtendedCacheItemPoolInterface::getItemsAsJsonString()*
+### ItemPool Events (Cluster) 
+- onCacheReplicationSlaveFallback(*Callable* **$callback**)
+    - **Callback arguments**
+        - *ClusterPoolInterface* **$self**
+        - *string* **$caller**
+    - **Scope**
+        - Cluster pool
+    - **Description**
+        - Allow you to get notified when a Master/Slave cluster switches on slave
+    - **Risky Circular Methods**
+        - N/A
+
+- onCacheReplicationRandomPoolChosen(*Callable* **$callback**)
+    - **Callback arguments**
+        - *ClusterPoolInterface* **$self**
+        - *ExtendedCacheItemPoolInterface* **$randomPool**
+    - **Scope**
+        - Cluster pool
+    - **Description**
+        - Allow you to get notified when a Random Replication cluster choose a cluster
+    - **Risky Circular Methods**
+        - N/A
 
+- onCacheClusterBuilt(*Callable* **$callback**)
+    - **Callback arguments**
+        - *AggregatorInterface* **$clusterAggregator**
+        - *ClusterPoolInterface* **$cluster**
+    - **Scope**
+        - Cluster aggregator
+    - **Description**
+        - Allow you to get notified when a cluster is being built
+    - **Risky Circular Methods**
+        - *$clusterAggregator::getCluster()*
+### ItemPool Events
 - onCacheItemSet(*Callable* **$callback**)
     - **Callback arguments**
         - *ExtendedCacheItemInterface* **$item**
@@ -173,4 +206,4 @@ List of active events:
     - **Risky Circular Methods**
         - *ExtendedCacheItemInterface::expiresAt()*
 
-This is an exhaustive list and it will be updated as soon as new events will be added to the Core.
+This is an exhaustive list and it will be updated as soon as new events will be added to the Core.

lib/Phpfastcache/Cluster/ClusterAggregator.php

@@ -151,9 +151,10 @@ public function getCluster(int $strategy = AggregatorInterface::STRATEGY_FULL_RE
 
                 /**
                  * @eventName CacheClusterBuilt
-                 * @param $_ AggregatablePoolInterface
+                 * @param $clusterAggregator AggregatorInterface
+                 * @param $cluster ClusterPoolInterface
                  */
-                $this->cluster->getEventManager()->dispatch('CacheClusterBuilt', $this->cluster);
+                $this->cluster->getEventManager()->dispatch('CacheClusterBuilt', $this, $this->cluster);
             }
         } else {
             throw new PhpfastcacheInvalidArgumentException('Unknown cluster strategy');

lib/Phpfastcache/Cluster/Drivers/RandomReplication/RandomReplicationCluster.php

@@ -41,6 +41,13 @@ public function __construct(string $clusterName, ExtendedCacheItemPoolInterface
         (new ReflectionMethod(\get_parent_class(\get_parent_class($this)), __FUNCTION__))
             ->invoke($this, $clusterName, ...$driverPools);
         $randomPool = $driverPools[\random_int(0, \count($driverPools) - 1)];
+
+        $this->eventManager->dispatch(
+            'CacheReplicationRandomPoolChosen',
+            $this,
+            $randomPool
+        );
+
         $this->clusterPools = [$randomPool];
     }