PHPSocialNetwork
diff --git a/‎.codeclimate.yml
+7-1 b/‎.codeclimate.yml
+7-1
diff --git a/‎.gitignore
+3-4 b/‎.gitignore
+3-4
diff --git a/‎.scrutinizer.yml
+25 b/‎.scrutinizer.yml
+25
diff --git a/‎.travis.yml
+8-4 b/‎.travis.yml
+8-4
diff --git a/‎README.md
+100-64 b/‎README.md
+100-64
diff --git a/‎V5-ROADMAP.md
+23 b/‎V5-ROADMAP.md
+23
diff --git a/‎bin/ci/install_dependencies.sh
+4 b/‎bin/ci/install_dependencies.sh
+4
diff --git a/‎bin/stubs/leveldb/README.md
+1 b/‎bin/stubs/leveldb/README.md
+1
@@ -38,6 +38,10 @@ engines:
         enabled: false
       Controversial/CamelCaseVariableName:
         enabled: false
+      Design/TooManyPublicMethods:
+        enabled: false
+      Design/NpathComplexity:
+        enabled: false
 ratings:
   paths:
   - "**.inc"
@@ -48,4 +52,6 @@ ratings:
   - "**.py"
   - "**.rb"
 exclude_paths:
-- "src/phpFastCache/_extensions/**"
+- "bin/**"
+- "examples/**"
+- "tests/**"
@@ -5,7 +5,6 @@
 *.pydevproject
 .project
 .metadata
-bin/
 tmp/
 *.tmp
 *.bak
@@ -51,7 +50,6 @@ local.properties
 [Rr]elease/
 x64/
 build/
-[Bb]in/
 [Oo]bj/
 
 # MSTest test Results
@@ -201,7 +199,7 @@ dist/
 build/
 eggs/
 parts/
-var/
+# var/
 sdist/
 develop-eggs/
 .installed.cfg
@@ -234,4 +232,5 @@ nbproject/
 
 #Composer
 vendor/
-composer.lock
+composer.lock
+composer.phar
@@ -0,0 +1,25 @@
+before_commands:
+    - "composer install --no-dev --prefer-source"
+
+filter:
+    excluded_paths: ["bin/*", "docs/*", "examples/*", "var/*", "vendor/*"]
+checks:
+    php: true
+coding_style:
+    php:
+        spaces:
+            around_operators:
+                concatenation: true
+tools:
+    external_code_coverage: false
+    php_code_coverage: true
+    php_code_sniffer:
+        enabled: true
+        config:
+            standard: PSR2
+        filter:
+            paths: ["src/*"]
+    php_mess_detector:
+        enabled: true
+        filter:
+            paths: ["src/*"]
@@ -12,16 +12,20 @@
 language: php
 services:
   - memcached
+  # - redis-server
+before_script: phpenv config-add var/php/conf/phpfastcache.ini
 php:
-  - 5.3
-  - 5.4
+  # - 5.3
+  # - 5.4
   - 5.5
   - 5.6
   - 7.0
-  # - nightly
+  - nightly
   # - hhvm We may need to do review this check later
-
+install:
+  - ./bin/ci/install_dependencies.sh
 script:
   - php -f tests/SyntaxChecker.test.php
   - php -f tests/Autoload.test.php
   - php -f tests/NewCacheInstance.test.php
+  - php -f tests/Psr6InterfaceImplements.test.php
@@ -1,29 +1,43 @@
-[![Code Climate](https://codeclimate.com/github/PHPSocialNetwork/phpfastcache/badges/gpa.svg)](https://codeclimate.com/github/PHPSocialNetwork/phpfastcache) [![Build Status](https://travis-ci.org/PHPSocialNetwork/phpfastcache.svg?branch=final)](https://travis-ci.org/PHPSocialNetwork/phpfastcache) [![Latest Stable Version](http://img.shields.io/packagist/v/phpfastcache/phpfastcache.svg)](https://packagist.org/packages/phpfastcache/phpfastcache) [![Total Downloads](http://img.shields.io/packagist/dt/phpfastcache/phpfastcache.svg)](https://packagist.org/packages/phpfastcache/phpfastcache) [![License](https://img.shields.io/packagist/l/phpfastcache/phpfastcache.svg)](https://packagist.org/packages/phpfastcache/phpfastcache) 
+[![Code Climate](https://codeclimate.com/github/PHPSocialNetwork/phpfastcache/badges/gpa.svg)](https://codeclimate.com/github/PHPSocialNetwork/phpfastcache) [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/PHPSocialNetwork/phpfastcache/badges/quality-score.png?b=final)](https://scrutinizer-ci.com/g/PHPSocialNetwork/phpfastcache/?branch=final) [![Build Status](https://travis-ci.org/PHPSocialNetwork/phpfastcache.svg?branch=final)](https://travis-ci.org/PHPSocialNetwork/phpfastcache) [![Latest Stable Version](http://img.shields.io/packagist/v/phpfastcache/phpfastcache.svg)](https://packagist.org/packages/phpfastcache/phpfastcache) [![Total Downloads](http://img.shields.io/packagist/dt/phpfastcache/phpfastcache.svg)](https://packagist.org/packages/phpfastcache/phpfastcache) [![Dependency Status](https://www.versioneye.com/php/phpfastcache:phpfastcache/badge.svg)](https://www.versioneye.com/php/phpfastcache:phpfastcache) [![License](https://img.shields.io/packagist/l/phpfastcache/phpfastcache.svg)](https://packagist.org/packages/phpfastcache/phpfastcache) [![Coding Standards](https://img.shields.io/badge/CI-PSR6-orange.svg)](https://github.com/php-fig/cache) 
 ---------------------------
 Simple Yet Powerful PHP Caching Class
 ---------------------------
 More information at http://www.phpfastcache.com
 One Class uses for All Cache. You don't need to rewrite your code many times again.
 
-Supported: SSDB, Redis, Predis, Cookie, Files, MemCache, MemCached, APC, WinCache, X-Cache, PDO with SQLite
+
+### Supported drivers at this day *
+
+| Regular drivers  | High performances drivers | Development driver |
+|------------------|---------------------------|--------------------|
+|  `Apc(u)`        | `CouchBase`               | `Devnull`          |
+|  `Cookie`        | `Mongodb`                 | `Devfalse`         |
+|  `Files`         | `Predis`                  | `Devtrue`          |
+|  `Leveldb`       | `Redis`                   |                    |
+|  `Memcache(d)`   | `Ssdb`                    |                    |
+|  `Sqlite`        |                           |                    |
+|  `Wincache`      |                           |                    |
+|  `Xcache`        |                           |                    |
+
+\* Driver descriptions available in DOCS/DRIVERS.md
+
+### Symfony developers are not forgotten !
+Starting of the v5, phpFastCache comes with a [Symfony Bundle](https://github.com/PHPSocialNetwork/phpfastcache-bundle).
+He's fresh, so feel free to report any bug or contribute to the code using pull requests.
 
 ---------------------------
 Not a "Traditional" Caching
 ---------------------------
-phpFastCache is not a traditional caching method which is keep read and write to files, sqlite or mass connections to memcache, redis, mongodb... phpFastCache use my unique caching method.
-When you use Files, and Sqlite, I am guarantee you still can get fast speed almost like memcache & redis for sure. Also, when you use Memcache / Memcached, your miss hits will be reduce.
-Different with normal caching methods which shared everywhere on internet, phpFastCache Lib reduce the high I/O load, and faster than traditional caching method at least x7 - 10 times.
+phpFastCache is not a traditional caching method which is keep read and write to files, sqlite or mass connections to memcache, redis, mongodb... Also, when you use Memcache / Memcached, your miss hits will be reduce.
+Different with normal caching methods which shared everywhere on internet, phpFastCache Lib reduce the high I/O load, and faster than traditional caching method at least x7 ~+ times.
 However, some time you still want to use traditional caching, we support them too.
 
 ```php
 use phpFastCache\CacheManager;
 
-// Default value: is "phpfastcache" (fastest), you can change to "normal" or "memory" (fast)
-CacheManager::CachingMethod("normal");
-
-// Recommend: use phpfastcache to reduce files I/O & CPU Load, Memcached missing hits, and make redis and other connections become faster.
-// If you get any error due to Server / Hosting, try to change to "memory" , act almost same way as "phpfastcache" but slower a little bit
-// In bad situation, use "normal" as traditional caching method
+CacheManager::getInstance('files', $config);
+// An alternative exists:
+CacheManager::Files($config);
 
 ```
 
@@ -38,18 +52,56 @@ With phpFastCache, your page only send 1 query to DB, and use the cache to serve
 Rich Development API
 ---------------------------
 
-phpFastCache offers you a lot of usefull APIS:
-
-- get($keyword) // The getter, obviously, return your cache object
-- set($keyword, $something_your_want_to_cache, $time_as_second = 0) // The setter, for those who missed it, put 0 meant cache it forever
-- delete($keyword) // For removing a cached thing
-- clean() // Allow you to completely empty the cache and restart from the beginning
-- touch($keyword, $time_you_want_to_extend) // Allow you to extends the lifetime of an entry without altering the value
-- increment($keyword, $step = 1) // For integer that we can count on
-- decrement($keyword, $step = 1) // Redundant joke...
-- search($string_or_regex, $search_in_value = false | true) // Allow you to perform some search on the cache index
-- isExisting($keyword) // Check if your cache entry exists, it is the equivalent of isset()
-- stats() // Return the cache statistics, useful for checking disk space used by the cache etc.
+phpFastCache offers you a lot of useful APIs:
+
+### Item API
+- getKey() // Return the item identifier (key)
+- get() // The getter, obviously, return your cache object
+- set($value) // The setter, for those who missed it, put 0 meant cache it forever
+- expiresAfter($ttl) // Allow you to extends the lifetime of an entry without altering the value (formerly known as touch())
+- expiresAt($expiration) // Sets the expiration time for this cache item (as a DateTimeInterface object)
+- increment($step = 1) // For integer that we can count on
+- decrement($step = 1) // Redundant joke...
+- append($data) // Append data to a string or an array (push)
+- prepend($data) // Prepend data to a string or an array (unshift)
+- isHit() // Check if your cache entry exists and is still valid, it is the equivalent of isset()
+- isExpired() // Check if your cache entry is expired
+- getTtl() // Get the remaining Time To Live as an integer
+- getExpirationDate() // Get the expiration date as a Datetime object
+- addTag($tagName) // Add a tag
+- addTags(array $tagNames) // Add many tags
+- setTags(array $tags) // Set some tags
+- getTags() // Get the tags
+- getTagsAsString($separator = ', ') // Get the data a string separated by $separator
+- removeTag($tagName) // Remove a tag
+- removeTags(array $tagNames) // Remove some tags
+- getDataAsJsonString()// Return the data as a well-formatted json string
+
+### ItemPool API
+- getItem($key) // Retrieve an item and returns an empty item if not found
+- getItems(array $keys) // Retrieve one or more item and returns an array of items
+- getItemsAsJsonString(array $keys) // Returns A json string that represents an array of items
+- hasItem($key) // Tests if an item exists
+- deleteItem($key) // Delete an item
+- deleteItems(array $keys) // Delete one or more items
+- save(CacheItemInterface $item) // Persists a cache item immediately
+- saveDeferred(CacheItemInterface $item); // Sets a cache item to be persisted later
+- commit(); // Persists any deferred cache items
+- clear() // Allow you to completely empty the cache and restart from the beginning
+- stats() // Return the cache statistics as an object, useful for checking disk space used by the cache etc.
+- getItemsByTag($tagName) // Return items by a tag
+- getItemsByTags(array $tagNames) // Return items by some tags
+- getItemsByTagsAsJsonString(array $tagNames) // Returns A json string that represents an array of items by tags-based
+- deleteItemsByTag($tagName) // Delete items by a tag
+- deleteItemsByTags(array $tagNames) // Delete items by some tags
+- incrementItemsByTag($tagName, $step = 1) // Increment items by a tag
+- incrementItemsByTags(array $tagNames, $step = 1) // Increment items by some tags
+- decrementItemsByTag($tagName, $step = 1) // Decrement items by a tag
+- decrementItemsByTags(array $tagNames, $step = 1) // Decrement items by some tags
+- appendItemsByTag($tagName, $data) // Append items by a tag
+- appendItemsByTags(array $tagNames, $data) // Append items by some tags
+- prependItemsByTag($tagName, $data) // Prepend items by a tag
+- prependItemsByTags(array $tagNames, $data) // Prepend items by some tags
 
 Also support Multiple calls, Tagging, Setup Folder for caching. Look at our examples folders.
 
@@ -69,68 +121,52 @@ composer require phpFastCache/phpFastCache
 ```php
 use phpFastCache\CacheManager;
 
-// require_once ('vendor/autoload.php');
+// Setup File Path on your config files
+CacheManager::setup(array(
+    "path" => '/var/www/phpfastcache.com/dev/tmp', // or in windows "C:/tmp/"
+));
 
-$cache = CacheManager::Files();
-
-// $cache = CacheManager::Memcached();
-// phpFastCache supported: SSDB, Redis, Predis, Cookie, Files, MemCache, MemCached, APC, WinCache, XCache, SQLite
-// $cache = CacheManager::getInstance("auto", $config);
-// $cache = CacheManager::getInstance("memcached", $server_config);
+// In your class, function, you can call the Cache
+$InstanceCache = CacheManager::getInstance('files');
 
 /**
  * Try to get $products from Caching First
  * product_page is "identity keyword";
  */
 $key = "product_page";
-$products = $cache->get($key);
+$CachedString = $InstanceCache->getItem($key);
+
+$your_product_data = [
+    'First product',
+    'Second product',
+    'Third product'
+    // etc...
+];
 
-if (is_null($products)) {
-    $products = "DB QUERIES | FUNCTION_GET_PRODUCTS | ARRAY | STRING | OBJECTS";
-    // Write products to Cache in 10 minutes with same keyword
-    $cache->set($key, $products, 600);
+if (is_null($CachedString->get())) {
+    $CachedString->set($your_product_data)->expiresAfter(5);//in seconds, also accepts Datetime
+	$InstanceCache->save($CachedString); // Save the cache item just like you do with doctrine and entities
 
-    echo " --> NO CACHE ---> DB | Func | API RUN FIRST TIME ---> ";
+    echo "FIRST LOAD // WROTE OBJECT TO CACHE // RELOAD THE PAGE AND SEE // ";
+    echo $CachedString->get();
 
 } else {
-    echo " --> USE CACHE --> SERV 10,000+ Visitors FROM CACHE ---> ";
+    echo "READ FROM CACHE // ";
+    echo $CachedString->get()[0];// Will prints 'First product'
 }
 
 /**
  * use your products here or return it;
  */
-echo $products;
-
-```
-
-#### :floppy_disk: Legacy / Lazy Method (Without Composer)
-```php
-// In your config files
-// require_once ('phpFastCache/src/autoload.php');
-
-use phpFastCache\CacheManager;
-
-// $cache = $cache = CacheManager::Files();
-// $cache = phpFastCache();
-// $cache = phpFastCache("files");
-// $cache = phpFastCache("memcached");
-
-/**
- * Try to get $products from Caching First
- * product_page is "identity keyword";
- */
-$key = "product_page";
-// $products = $cache->get($key);
-$products = CacheManager::get($key);
-// CacheManager::set() , ::touch ::increment ::search ..etc, work same way without create new instance
-
-// yet it's the same as autoload
+echo implode('<br />', $CachedString->get());// Will echo your product list
 
 ```
 
+##### :floppy_disk: Legacy / Lazy Method (Without Composer)
+* See the file examples/legacy.php for more information.
 
 #### :zap: Step 3: Enjoy ! Your website is now faster than flash !
 For curious developpers, there is a lot of others available examples [here](https://github.com/khoaofgod/phpFastCache/tree/final/examples).
 
 #### :boom: phpFastCache support
-Found an issue or had an idea ? Come [here](https://github.com/PHPSocialNetwork/phpfastcache/issues) and let you know !
+Found an issue or had an idea ? Come [here](https://github.com/PHPSocialNetwork/phpfastcache/issues) and let us know !
@@ -0,0 +1,23 @@
+### phpFastCache V5 Roadmap
+
+- [x] Refactoring driver to be psr6 compliant
+- [x] Rewrite examples by drivers
+- [x] Rewrite examples for complex setups 
+- [x] Rewrite examples for non-composer users
+- [x] Re-implement standalone Autoload for non-composer user
+- [x] Rewrite examples for ssdb lib
+- [x] Rewrite Readme 
+- [x] Rewrite tests
+- [x] Rewrite stats method to be implemented in a driverStatistic() object, not a breaking change due to ArrayAccess use, but array use is deprecated
+- [x] Re-implement tags features (will be the replacement of global search)
+- [x] Re-implement [in|de]crement methods in ExtendedCacheItemInterface 
+- [x] Implement [a|pre]pend methods in ExtendedCacheItemInterface 
+- [x] Re-implement touch method in ExtendedCacheItemInterface: deprecated in profit CacheItemInterface::expiresAfter()
+- [x] Implement MongoDb Driver
+- [x] Implement CouchBase Driver
+- [x] Implement Dev Driver (return null/bool everywhere for development purpose)
+- [x] Implement advanced tags features: incrementByTag(s), decrementByTag(s), appendByTag(s), prependByTag(s), expiresAfterByTag(s)
+- [x] Final code review + psr2 checks + psr-6 null value as legitimates value.
+- [x] Testing fallback option
+- [x] Rewrite Wiki 
+- [ ] Check Wincache driver in real Windows env (and not in VM)
@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+
+composer self-update;
+composer update;
@@ -0,0 +1 @@
+Please see: https://github.com/reeze/php-leveldb for more documentation
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+Please see: https://github.com/reeze/php-leveldb for more documentation`