Added more documentation

Author: byjg

README.md

@@ -16,14 +16,15 @@ of engines available in this library that is PSR-16 compliant:
 
 {:.table}
 
-| Class                                   | Description                                                         |
-|:----------------------------------------|:--------------------------------------------------------------------|
-| \ByJG\Cache\Psr16\NoCacheEngine         | Do nothing. Use it for disable the cache without change your code   |
-| \ByJG\Cache\Psr16\ArrayCacheEngine      | Local cache only using array. It does not persists between requests |
-| \ByJG\Cache\Psr16\FileSystemCacheEngine | Save the cache result in the local file system                      |
-| \ByJG\Cache\Psr16\MemcachedEngine       | Uses the Memcached as the cache engine                              |
-| \ByJG\Cache\Psr16\SessionCachedEngine   | uses the PHP session as cache                                       |
-| \ByJG\Cache\Psr16\ShmopCachedEngine     | uses the shared memory area for cache                               |
+| Class                                                                            | Description                                                         |
+|:---------------------------------------------------------------------------------|:--------------------------------------------------------------------|
+| [\ByJG\Cache\Psr16\NoCacheEngine](docs/class-no-cache-engine.md)                 | Do nothing. Use it for disable the cache without change your code   |
+| [\ByJG\Cache\Psr16\ArrayCacheEngine](docs/class-array-cache-engine.md)           | Local cache only using array. It does not persists between requests |
+| [\ByJG\Cache\Psr16\FileSystemCacheEngine](docs/class-filesystem-cache-engine.md) | Save the cache result in the local file system                      |
+| [\ByJG\Cache\Psr16\MemcachedEngine](docs/class-memcached-engine.md)              | Uses the Memcached as the cache engine                              |
+| [\ByJG\Cache\Psr16\RedisCachedEngine](docs/class-redis-cache-engine.md)          | uses the Redis as cache                                             |
+| [\ByJG\Cache\Psr16\SessionCachedEngine](docs/class-session-cache-engine.md)      | uses the PHP session as cache                                       |
+| [\ByJG\Cache\Psr16\ShmopCachedEngine](docs/class-shmop-cache-engine.md)          | uses the shared memory area for cache                               |
 
 To create a new Cache Instance just create the proper cache engine and use it:
 

composer.json

@@ -7,7 +7,7 @@
     }
   },
   "require": {
-    "php": ">=5.6.0",
+    "php": ">=7.0",
     "psr/cache": "^1.0",
     "psr/log": "^1.1",
     "psr/simple-cache": "^1.0"

docs/class-array-cache-engine.md

@@ -0,0 +1,27 @@
+# Class ArrayCacheEngine
+
+This class is a simple cache engine that uses an array to store the values. 
+It does not persists between requests. 
+
+It is ideal to use on unit tests or when you need a simple cache engine.
+
+
+## PSR-16 Constructor
+
+```php
+$cache = new \ByJG\Cache\Psr16\ArrayCacheEngine()
+```
+
+## PSR-6 Constructor
+
+```php
+$cachePool = \ByJG\Cache\Factory::createArrayPool()
+```
+
+or
+
+```php
+$cachePool = new \ByJG\Cache\Psr6\CachePool(new \ByJG\Cache\Psr16\ArrayCacheEngine());
+```
+
+

docs/class-filesystem-cache-engine.md

@@ -0,0 +1,30 @@
+# Class FilesystemCacheEngine
+
+This class uses the Filesystem as the cache engine.
+
+## Defining the Path
+
+The FileSystemCacheEngine expects a prefix and a path to store the cache files.
+The prefix is used to avoid collision between different applications using the same cache path.
+If the path is not defined, the default is the system temporary path.
+
+
+## PSR-16 Constructor
+
+```php
+$cache = new \ByJG\Cache\Psr16\FileSystemCacheEngine($path, $prefix)
+```
+
+## PSR-6 Constructor
+
+```php
+$cachePool = \ByJG\Cache\Factory::createFilePool($path, $prefix, $bufferSize = 10)
+```
+
+or
+
+```php
+$cachePool = new \ByJG\Cache\Psr6\CachePool(new \ByJG\Cache\Psr16\FileSystemCacheEngine($path, $prefix));
+```
+
+

docs/class-memcached-engine.md

@@ -0,0 +1,34 @@
+# Class MemcachedEngine
+
+This class uses the Memcached as the cache engine.
+
+## Defining the Servers
+
+The constructor expects an array of servers. 
+Each server is an item in the array with the following format:
+
+```php
+$servers = [
+    'localhost:11211',
+]
+```
+
+## PSR-16 Constructor
+
+```php
+$cache = new \ByJG\Cache\Psr16\MemcachedEngine($servers)
+```
+
+## PSR-6 Constructor
+
+```php
+$cachePool = \ByJG\Cache\Factory::createMemcachedPool($servers)
+```
+
+or
+
+```php
+$cachePool = new \ByJG\Cache\Psr6\CachePool(new \ByJG\Cache\Psr16\MemcachedEngine($servers));
+```
+
+

docs/class-no-cache-engine.md

@@ -0,0 +1,24 @@
+# Class NoCacheEngine
+
+This class don't cache. Use it for disable the cache without change your code.
+
+
+## PSR-16 Constructor
+
+```php
+$cache = new \ByJG\Cache\Psr16\NoCacheEngine();
+```
+
+## PSR-6 Constructor
+
+```php
+$cachePool = \ByJG\Cache\Factory::createNullPool();
+```
+
+or
+
+```php
+$cachePool = new \ByJG\Cache\Psr6\CachePool(new \ByJG\Cache\Psr16\NoCacheEngine());
+```
+
+

docs/class-redis-cache-engine.md

@@ -0,0 +1,31 @@
+# Class RedisCacheEngine
+
+This class uses the Redis as the cache engine.
+
+## Defining the Servers
+
+The constructor expects a string with the server and port.
+
+```php
+$server = 'localhost:5678'
+```
+
+## PSR-16 Constructor
+
+```php
+$cache = new \ByJG\Cache\Psr16\RedisCacheEngine($server, $password)
+```
+
+## PSR-6 Constructor
+
+```php
+$cachePool = \ByJG\Cache\Factory::createRedisCacheEngine($server, $password)
+```
+
+or
+
+```php
+$cachePool = new \ByJG\Cache\Psr6\CachePool(new \ByJG\Cache\Psr16\RedisCacheEngine($server, $password));
+```
+
+

docs/class-session-cache-engine.md

@@ -0,0 +1,27 @@
+# Class SessionCacheEngine
+
+This class uses the PHP Session as the cache engine. 
+This will persist the cache between requests while the user session is active.
+
+The cache is not shared between different users.
+
+
+## PSR-16 Constructor
+
+```php
+$cache = new \ByJG\Cache\Psr16\SessionCacheEngine($prefix)
+```
+
+## PSR-6 Constructor
+
+```php
+$cachePool = \ByJG\Cache\Factory::createSessionPool($prefix, $bufferSize = 10)
+```
+
+or
+
+```php
+$cachePool = new \ByJG\Cache\Psr6\CachePool(new \ByJG\Cache\Psr16\SessionCacheEngine($prefix));
+```
+
+

docs/class-shmop-cache-engine.md

@@ -0,0 +1,38 @@
+# Class ShmopCacheEngine
+
+This class uses the PHP Shmop as the cache engine. 
+
+The Shared memory allows multiple processes to access the same data in memory. 
+You can use it to share data among running PHP scripts in the same server.
+
+## Configuration
+
+These are the default values for the configuration:
+
+```php
+$config = [
+    'max-size' => 524288, // 512Kb
+    'default-permission' = > '0700', 
+];
+```
+
+
+## PSR-16 Constructor
+
+```php
+$cache = new \ByJG\Cache\Psr16\ShmopCacheEngine($config, $prefix)
+```
+
+## PSR-6 Constructor
+
+```php
+$cachePool = \ByJG\Cache\Factory::createSessionPool($prefix, $bufferSize = 10)
+```
+
+or
+
+```php
+$cachePool = new \ByJG\Cache\Psr6\CachePool(new \ByJG\Cache\Psr16\ShmopCacheEngine($config, $prefix));
+```
+
+

src/Factory.php

@@ -28,10 +28,10 @@ public static function createSessionPool($prefix = null, $bufferSize = null)
         );
     }
 
-    public static function createFilePool($prefix = null, $bufferSize = null, $logger = null)
+    public static function createFilePool($prefix = null, $path = null, $bufferSize = null, $logger = null)
     {
         return new CachePool(
-            new FileSystemCacheEngine($prefix, $logger),
+            new FileSystemCacheEngine($prefix, $path, $logger),
             $bufferSize
         );
     }