Improve PHPDoc for the Illuminate\Cache folder files (#56028)

Author: JordanchoEftimov

src/Illuminate/Cache/ArrayLock.php

@@ -82,7 +82,7 @@ public function release()
     /**
      * Returns the owner value written into the driver for this lock.
      *
-     * @return string
+     * @return string|null
      */
     protected function getCurrentOwner()
     {

src/Illuminate/Cache/DatabaseLock.php

@@ -44,6 +44,7 @@ class DatabaseLock extends Lock
      * @param  int  $seconds
      * @param  string|null  $owner
      * @param  array  $lottery
+     * @param  int  $defaultTimeoutInSeconds
      */
     public function __construct(Connection $connection, $table, $name, $seconds, $owner = null, $lottery = [2, 100], $defaultTimeoutInSeconds = 86400)
     {

src/Illuminate/Cache/DatabaseStore.php

@@ -76,6 +76,7 @@ class DatabaseStore implements LockProvider, Store
      * @param  string  $prefix
      * @param  string  $lockTable
      * @param  array  $lockLottery
+     * @param  int  $defaultLockTimeoutInSeconds
      */
     public function __construct(
         ConnectionInterface $connection,
@@ -169,6 +170,7 @@ public function put($key, $value, $seconds)
     /**
      * Store multiple items in the cache for a given number of seconds.
      *
+     * @param  array  $values
      * @param  int  $seconds
      * @return bool
      */

src/Illuminate/Cache/Events/CacheFlushFailed.php

@@ -22,6 +22,7 @@ class CacheFlushFailed
      * Create a new event instance.
      *
      * @param  string|null  $storeName
+     * @param  array  $tags
      */
     public function __construct($storeName, array $tags = [])
     {

src/Illuminate/Cache/Events/CacheFlushed.php

@@ -22,6 +22,7 @@ class CacheFlushed
      * Create a new event instance.
      *
      * @param  string|null  $storeName
+     * @param  array  $tags
      */
     public function __construct($storeName, array $tags = [])
     {

src/Illuminate/Cache/Events/CacheFlushing.php

@@ -22,6 +22,7 @@ class CacheFlushing
      * Create a new event instance.
      *
      * @param  string|null  $storeName
+     * @param  array  $tags
      */
     public function __construct($storeName, array $tags = [])
     {

src/Illuminate/Cache/MemoizedStore.php

@@ -108,6 +108,7 @@ public function put($key, $value, $seconds)
     /**
      * Store multiple items in the cache for a given number of seconds.
      *
+     * @param  array  $values
      * @param  int  $seconds
      * @return bool
      */

src/Illuminate/Cache/RedisTagSet.php

@@ -90,6 +90,7 @@ public function flushStaleEntries()
      * Flush the tag from the cache.
      *
      * @param  string  $name
+     * @return string
      */
     public function flushTag($name)
     {