Added some PHPDoc comments

Author: byjg

src/Psr16/ArrayCacheEngine.php

@@ -49,6 +49,7 @@ public function has($key)
      * @param string $key The object KEY
      * @param mixed $default IGNORED IN MEMCACHED.
      * @return mixed Description
+     * @throws \Psr\SimpleCache\InvalidArgumentException
      */
     public function get($key, $default = null)
     {

src/Psr16/BaseCacheEngine.php

@@ -8,6 +8,13 @@
 
 abstract class BaseCacheEngine implements CacheInterface, CacheAvailabilityInterface
 {
+    /**
+     * @param $keys
+     * @param null $default
+     * @return array|iterable
+     * @throws \ByJG\Cache\InvalidArgumentException
+     * @throws \Psr\SimpleCache\InvalidArgumentException
+     */
     public function getMultiple($keys, $default = null)
     {
         if (!is_array($keys)) {
@@ -20,13 +27,24 @@ public function getMultiple($keys, $default = null)
         return $result;
     }
 
+    /**
+     * @param iterable $values
+     * @param null $ttl
+     * @return bool|void
+     * @throws \Psr\SimpleCache\InvalidArgumentException
+     */
     public function setMultiple($values, $ttl = null)
     {
         foreach ($values as $key => $value) {
             $this->set($key, $value, $ttl);
         }
     }
 
+    /**
+     * @param iterable $keys
+     * @return bool|void
+     * @throws \Psr\SimpleCache\InvalidArgumentException
+     */
     public function deleteMultiple($keys)
     {
         foreach ($keys as $key) {

src/Psr16/FileSystemCacheEngine.php

@@ -115,6 +115,7 @@ public function set($key, $value, $ttl = null)
     /**
      * @param string $key
      * @return bool
+     * @throws \Psr\SimpleCache\InvalidArgumentException
      */
     public function delete($key)
     {

src/Psr16/MemcachedEngine.php

@@ -37,6 +37,9 @@ protected function fixKey($key) {
         return "cache-" . $key;
     }
 
+    /**
+     * @throws \Exception
+     */
     protected function lazyLoadMemCachedServers()
     {
         if (is_null($this->memCached)) {
@@ -57,6 +60,7 @@ protected function lazyLoadMemCachedServers()
      * @param string $key The object KEY
      * @param int $default IGNORED IN MEMCACHED.
      * @return mixed Description
+     * @throws \Exception
      */
     public function get($key, $default = null)
     {
@@ -76,6 +80,7 @@ public function get($key, $default = null)
      * @param object $value The object to be cached
      * @param int $ttl The time to live in seconds of this objects
      * @return bool If the object is successfully posted
+     * @throws \Exception
      */
     public function set($key, $value, $ttl = null)
     {
@@ -93,6 +98,7 @@ public function set($key, $value, $ttl = null)
     /**
      * @param string $key
      * @return bool
+     * @throws \Exception
      */
     public function delete($key)
     {
@@ -116,13 +122,22 @@ public function isAvailable()
         }
     }
 
+    /**
+     * @return bool
+     * @throws \Exception
+     */
     public function clear()
     {
         $this->lazyLoadMemCachedServers();
         $result = $this->memCached->flush();
         return $result;
     }
 
+    /**
+     * @param string $key
+     * @return bool
+     * @throws \Exception
+     */
     public function has($key)
     {
         $this->lazyLoadMemCachedServers();

src/Psr6/CachePool.php

@@ -107,9 +107,11 @@ protected function removeElementFromBuffer($key)
 
     /**
      * Psr implementation of getItem()
-     * 
+     *
      * @param string $key
      * @return CacheItem
+     * @throws \Psr\SimpleCache\InvalidArgumentException
+     * @throws \Psr\SimpleCache\InvalidArgumentException
      */
     public function getItem($key)
     {
@@ -132,9 +134,10 @@ public function getItem($key)
 
     /**
      * Psr implementation of getItems()
-     * 
+     *
      * @param array $keys
      * @return array
+     * @throws \Psr\SimpleCache\InvalidArgumentException
      */
     public function getItems(array $keys = array())
     {
@@ -148,9 +151,10 @@ public function getItems(array $keys = array())
 
     /**
      * Psr implementation of hasItems()
-     * 
+     *
      * @param string $key
      * @return bool
+     * @throws \Psr\SimpleCache\InvalidArgumentException
      */
     public function hasItem($key)
     {
@@ -171,6 +175,7 @@ public function clear()
      *
      * @param string $key
      * @return bool
+     * @throws \Psr\SimpleCache\InvalidArgumentException
      */
     public function deleteItem($key)
     {
@@ -179,9 +184,11 @@ public function deleteItem($key)
 
     /**
      * Psr Implementation of deleteItems()
-     * 
+     *
      * @param array $keys
      * @return bool
+     * @throws \Psr\SimpleCache\InvalidArgumentException
+     * @throws \Psr\SimpleCache\InvalidArgumentException
      */
     public function deleteItems(array $keys)
     {
@@ -196,6 +203,8 @@ public function deleteItems(array $keys)
     /**
      * @param CacheItemInterface $item
      * @return bool
+     * @throws \Psr\SimpleCache\InvalidArgumentException
+     * @throws \Psr\SimpleCache\InvalidArgumentException
      */
     public function save(CacheItemInterface $item)
     {
@@ -232,6 +241,8 @@ public function saveDeferred(CacheItemInterface $item)
 
     /**
      * Psr implementation of commit()
+     *
+     * @throws \Psr\SimpleCache\InvalidArgumentException
      */
     public function commit()
     {