feat: adicionar documentação de métodos e construtores em várias classes

Author: CAFernandes

src/Cache/CacheInterface.php

@@ -17,7 +17,19 @@ public function get(string $key, $default = null);
      * @param mixed $value
      */
     public function set(string $key, $value, ?int $ttl = null): bool;
+    
+    /**
+     * Delete a cache entry by key
+     */
     public function delete(string $key): bool;
+    
+    /**
+     * Clear all cache entries
+     */
     public function clear(): bool;
+    
+    /**
+     * Check if a cache entry exists
+     */
     public function has(string $key): bool;
 }

src/Cache/FileCache.php

@@ -66,6 +66,9 @@ public function set(string $key, $value, ?int $ttl = null): bool
         return file_put_contents($file, serialize($data)) !== false;
     }
 
+    /**
+     * Delete a cache entry by key
+     */
     public function delete(string $key): bool
     {
         $file = $this->getFilePath($key);
@@ -77,6 +80,9 @@ public function delete(string $key): bool
         return true;
     }
 
+    /**
+     * Clear all cache entries
+     */
     public function clear(): bool
     {
         $files = glob($this->cacheDir . '/*');
@@ -92,6 +98,9 @@ public function clear(): bool
         return true;
     }
 
+    /**
+     * Check if a cache entry exists
+     */
     public function has(string $key): bool
     {
         return $this->get($key) !== null;

src/Cache/MemoryCache.php

@@ -44,18 +44,27 @@ public function set(string $key, $value, ?int $ttl = null): bool
         return true;
     }
 
+    /**
+     * Delete a cache entry by key
+     */
     public function delete(string $key): bool
     {
         unset($this->cache[$key]);
         return true;
     }
 
+    /**
+     * Clear all cache entries
+     */
     public function clear(): bool
     {
         $this->cache = [];
         return true;
     }
 
+    /**
+     * Check if a cache entry exists
+     */
     public function has(string $key): bool
     {
         return isset($this->cache[$key]);

src/Database/Database.php

@@ -10,6 +10,9 @@ class Database
     private \PDO $pdo;
     private array $config;
 
+    /**
+     * __construct method
+     */
     public function __construct(array $config)
     {
         $this->config = $config;

src/Events/Event.php

@@ -11,6 +11,9 @@ class Event
     private array $data;
     private bool $propagationStopped = false;
 
+    /**
+     * __construct method
+     */
     public function __construct(string $name, array $data = [])
     {
         $this->name = $name;

src/Http/Optimization/ArrayView.php

@@ -17,6 +17,9 @@ class ArrayView implements \ArrayAccess, \Iterator, \Countable
     private array $keys;
     private int $position = 0;
 
+    /**
+     * __construct method
+     */
     public function __construct(
         array &$source,
         int $offset,
@@ -29,11 +32,17 @@ public function __construct(
         $this->keys = array_slice(array_keys($source), $this->offset, $this->length);
     }
 
+    /**
+     * OffsetExists method
+     */
     public function offsetExists($offset): bool
     {
         return isset($this->keys[$offset]);
     }
 
+    /**
+     * OffsetGet method
+     */
     public function offsetGet($offset): mixed
     {
         if (!$this->offsetExists($offset)) {
@@ -43,6 +52,9 @@ public function offsetGet($offset): mixed
         return $this->source[$realKey];
     }
 
+    /**
+     * OffsetSet method
+     */
     public function offsetSet($offset, $value): void
     {
         if ($this->offsetExists($offset)) {
@@ -51,6 +63,9 @@ public function offsetSet($offset, $value): void
         }
     }
 
+    /**
+     * OffsetUnset method
+     */
     public function offsetUnset($offset): void
     {
         if ($this->offsetExists($offset)) {
@@ -61,32 +76,50 @@ public function offsetUnset($offset): void
         }
     }
 
+    /**
+     * Current method
+     */
     public function current(): mixed
     {
         $key = $this->keys[$this->position];
         return $this->source[$key];
     }
 
+    /**
+     * Key method
+     */
     public function key(): mixed
     {
         return $this->keys[$this->position];
     }
 
+    /**
+     * Next method
+     */
     public function next(): void
     {
         $this->position++;
     }
 
+    /**
+     * Rewind method
+     */
     public function rewind(): void
     {
         $this->position = 0;
     }
 
+    /**
+     * Valid method
+     */
     public function valid(): bool
     {
         return $this->position < count($this->keys);
     }
 
+    /**
+     * Count method
+     */
     public function count(): int
     {
         return count($this->keys);

src/Http/Optimization/MemoryMapping.php

@@ -19,6 +19,9 @@ class MemoryMapping
     private int $cacheSize = 0;
     private const MAX_CACHE_SIZE = 1024 * 1024; // 1MB cache per mapping
 
+    /**
+     * __construct method
+     */
     public function __construct(
         string $filePath,
         int $offset = 0,

src/Http/Optimization/StreamView.php

@@ -29,6 +29,9 @@ public function __construct(
         $this->length = $length ?? ($fileSize - $offset);
     }
 
+    /**
+     * Read method
+     */
     public function read(?int $bytes = null): string|false
     {
         if (!$this->handle) {
@@ -76,6 +79,9 @@ public function stream($destination, int $chunkSize = 8192): int
         return $totalBytes;
     }
 
+    /**
+     * __destruct method
+     */
     public function __destruct()
     {
         if ($this->handle) {

src/Http/Psr7/Response.php

@@ -80,6 +80,9 @@ class Response extends Message implements ResponseInterface
         511 => 'Network Authentication Required',
     ];
 
+    /**
+     * __construct method
+     */
     public function __construct(
         int $statusCode = 200,
         array $headers = [],