- Updated EventManager now MUST implement Phpfastcache\Event\EventInterface

- Upgraded API version from 2.0.2 to 2.0.3

Author: Geolim4

CHANGELOG_API.md

@@ -1,3 +1,7 @@
+## 2.0.3
+- Updated ExtendedCacheItemPoolInterface::setEventManager() first argument that now MUSt implement `\Phpfastcache\Event\EventInterface`
+- Updated ExtendedCacheItemInterface::setEventManager() first argument that now MUSt implement `\Phpfastcache\Event\EventInterface`
+
 ## 2.0.2
 - Added ExtendedCacheItemPoolInterface::isUsableInAutoContext() to check if the driver is allowed to be used in 'Auto' context.
 

lib/Phpfastcache/Api.php

@@ -24,7 +24,7 @@
  */
 class Api
 {
-    protected static $version = '2.0.2';
+    protected static $version = '2.0.3';
 
     /**
      * Api constructor.

lib/Phpfastcache/Core/Item/ExtendedCacheItemInterface.php

@@ -16,7 +16,7 @@
 namespace Phpfastcache\Core\Item;
 
 use Phpfastcache\Core\Pool\ExtendedCacheItemPoolInterface;
-use Phpfastcache\EventManager;
+use Phpfastcache\Event\EventInterface;
 use Phpfastcache\Exceptions\{
   PhpfastcacheInvalidArgumentException, PhpfastcacheLogicException
 };
@@ -214,8 +214,8 @@ public function getDataAsJsonString($option = 0, $depth = 512): string;
     /**
      * Set the EventManager instance
      *
-     * @param EventManager $em
+     * @param EventInterface $em
      * @return self
      */
-    public function setEventManager(EventManager $em): self;
+    public function setEventManager(EventInterface $em): self;
 }

lib/Phpfastcache/Core/Item/ItemExtendedTrait.php

@@ -16,7 +16,7 @@
 namespace Phpfastcache\Core\Item;
 
 use Phpfastcache\Core\Pool\ExtendedCacheItemPoolInterface;
-use Phpfastcache\EventManager;
+use Phpfastcache\Event\EventInterface;
 use Phpfastcache\Exceptions\{
   PhpfastcacheInvalidArgumentException, PhpfastcacheInvalidArgumentTypeException, PhpfastcacheLogicException
 };
@@ -42,7 +42,7 @@ trait ItemExtendedTrait
      *******************/
 
     /**
-     * @var EventManager
+     * @var EventInterface
      */
     protected $eventManager;
 
@@ -441,10 +441,10 @@ public function jsonSerialize()
     /**
      * Set the EventManager instance
      *
-     * @param EventManager $em
+     * @param EventInterface $em
      * @return ExtendedCacheItemInterface
      */
-    public function setEventManager(EventManager $em): ExtendedCacheItemInterface
+    public function setEventManager(EventInterface $em): ExtendedCacheItemInterface
     {
         $this->eventManager = $em;
 

lib/Phpfastcache/Core/Pool/ExtendedCacheItemPoolInterface.php

@@ -19,11 +19,10 @@
 use Phpfastcache\Config\ConfigurationOption;
 use Phpfastcache\Core\Item\ExtendedCacheItemInterface;
 use Phpfastcache\Entities\DriverStatistic;
-use Phpfastcache\EventManager;
+use Phpfastcache\Event\EventInterface;
 use Phpfastcache\Exceptions\{
   PhpfastcacheInvalidArgumentException, PhpfastcacheLogicException
 };
-use Phpfastcache\Util\ArrayObject;
 use Psr\Cache\{CacheItemInterface, CacheItemPoolInterface};
 
 
@@ -516,10 +515,10 @@ public function isAttached(CacheItemInterface $item);
     /**
      * Set the EventManager instance
      *
-     * @param EventManager $em
+     * @param EventInterface $em
      * @return self
      */
-    public function setEventManager(EventManager $em): self;
+    public function setEventManager(EventInterface $em): self;
 
     /**
      * Save multiple items, possible uses:

lib/Phpfastcache/Core/Pool/ExtendedCacheItemPoolTrait.php

@@ -16,7 +16,7 @@
 namespace Phpfastcache\Core\Pool;
 
 use Phpfastcache\Core\Item\ExtendedCacheItemInterface;
-use Phpfastcache\EventManager;
+use Phpfastcache\Event\EventInterface;
 use Phpfastcache\Exceptions\{
   PhpfastcacheInvalidArgumentException, PhpfastcacheLogicException
 };
@@ -458,10 +458,10 @@ public function isAttached(CacheItemInterface $item)
     /**
      * Set the EventManager instance
      *
-     * @param EventManager $em
+     * @param EventInterface $em
      * @return ExtendedCacheItemPoolInterface
      */
-    public function setEventManager(EventManager $em): ExtendedCacheItemPoolInterface
+    public function setEventManager(EventInterface $em): ExtendedCacheItemPoolInterface
     {
         $this->eventManager = $em;
 

lib/Phpfastcache/Event/EventInterface.php

@@ -0,0 +1,40 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * User: Geolim4
+ * Date: 29/04/2018
+ * Time: 23:28
+ */
+
+namespace Phpfastcache\Event;
+
+use Phpfastcache\Exceptions\PhpfastcacheInvalidArgumentException;
+
+interface EventInterface
+{
+    /**
+     * @return self
+     */
+    public static function getInstance(): self;
+
+    /**
+     * @param string $eventName
+     * @param array ...$args
+     */
+    public function dispatch(string $eventName, ...$args);
+
+    /**
+     * @param string $name
+     * @param array $arguments
+     * @throws PhpfastcacheInvalidArgumentException
+     * @throws \BadMethodCallException
+     */
+    public function __call(string $name, array $arguments);
+
+    /**
+     * @param string $eventName
+     * @param string $callbackName
+     * @return bool
+     */
+    public function unbindEventCallback(string $eventName, string $callbackName): bool;
+}

lib/Phpfastcache/EventManager.php

@@ -15,6 +15,7 @@
 
 namespace Phpfastcache;
 
+use Phpfastcache\Event\EventInterface;
 use Phpfastcache\Exceptions\PhpfastcacheInvalidArgumentException;
 
 /**
@@ -38,7 +39,7 @@
  *
  *
  */
-class EventManager
+class EventManager implements EventInterface
 {
     /**
      * @var $this
@@ -51,18 +52,19 @@ class EventManager
     protected $events = [];
 
     /**
-     * @return \Phpfastcache\EventManager
+     * @return EventInterface
      */
-    public static function getInstance(): self
+    public static function getInstance(): EventInterface
     {
         return (self::$instance ?: self::$instance = new self);
     }
 
     /**
      * EventManager constructor.
      */
-    protected function __construct()
+    final protected function __construct()
     {
+        // The constructor should not be instantiated externally
     }
 
     /**

lib/Phpfastcache/Helper/ActOnAll.php

@@ -15,7 +15,9 @@
 
 namespace Phpfastcache\Helper;
 
-use Phpfastcache\{CacheManager, EventManager};
+use Phpfastcache\{
+  CacheManager, Event\EventInterface, EventManager
+};
 use Phpfastcache\Core\Pool\ExtendedCacheItemPoolInterface;
 use Phpfastcache\Entities\DriverStatistic;
 use Psr\Cache\CacheItemInterface;
@@ -466,10 +468,10 @@ public function isAttached(CacheItemInterface $item): array
     }
 
     /**
-     * @param \Phpfastcache\EventManager $em
+     * @param EventInterface $em
      * @return array
      */
-    public function setEventManager(EventManager $em): array
+    public function setEventManager(EventInterface $em): array
     {
         $callback = $this->getGenericCallback();
         return $callback(__FUNCTION__, func_get_args());