Initial commit

2016-06-28 23:18:59 +02:00
parent e321e10551
commit e49c2c27ad
390 changed files with 22561 additions and 0 deletions
--- a/lib/phpfastcache/phpFastCache/Core/DriverAbstract.php
+++ b/lib/phpfastcache/phpFastCache/Core/DriverAbstract.php
@ -0,0 +1,846 @@
+<?php
+/**
+ *
+ * This file is part of phpFastCache.
+ *
+ * @license MIT License (MIT)
+ *
+ * For full copyright and license information, please see the docs/CREDITS.txt file.
+ *
+ * @author Khoa Bui (khoaofgod)  <khoaofgod@gmail.com> http://www.phpfastcache.com
+ * @author Georges.L (Geolim4)  <contact@geolim4.com>
+ *
+ */
+
+namespace phpFastCache\Core;
+
+use phpFastCache\Exceptions\phpFastCacheDriverException;
+use phpFastCache\CacheManager;
+
+/**
+ * Class DriverAbstract
+ * @package phpFastCache\Core
+ */
+abstract class DriverAbstract implements DriverInterface
+{
+
+    /**
+     * @var array
+     */
+    public $extension_dir = '_extensions';
+
+    /**
+     * @var array
+     */
+    public $tmp = array();
+
+    /**
+     * @var array default options, this will be merge to Driver's Options
+     */
+    public $config = array();
+
+    /**
+     * @var bool
+     */
+    public $fallback = false;
+
+    /**
+     * @var
+     */
+    public $instant;
+
+
+    public function __destruct()
+    {
+        // clean up the memory and don't want for PHP clean for caching method "phpfastcache"
+        if (isset($this->config[ 'instance' ]) && (int)$this->config[ 'cache_method' ] === 3) {
+            CacheManager::cleanCachingMethod($this->config[ 'instance' ]);
+        }
+    }
+
+    /**
+     * @param $keyword
+     * @return string
+     */
+    protected function encodeFilename($keyword)
+    {
+        // return trim(trim(preg_replace('/[^a-zA-Z0-9]+/', '_', $keyword), '_'));
+        // return rtrim(base64_encode($keyword), '=');
+        return md5($keyword);
+    }
+
+    /**
+     * Basic Functions
+     * @param $keyword
+     * @param string $value
+     * @param int $time
+     * @param array $option
+     * @return bool|null
+     */
+    public function set($keyword, $value = '', $time = 0, $option = array())
+    {
+        /**
+         * Infinity Time
+         * Khoa. B
+         */
+        if ((int)$time <= 0) {
+            /**
+             * 5 years, however memcached or memory cached will gone when u restart it
+             * just recommended for sqlite. files
+             */
+            $time = 3600 * 24 * 365 * 5;
+        }
+
+        /**
+         * Temporary disabled phpFastCache::$disabled = true
+         * Khoa. B
+         */
+        if (phpFastCache::$disabled === true) {
+            return false;
+        }
+        $object = array(
+          "value" => $value,
+          "write_time" => time(),
+          "expired_in" => $time,
+          "expired_time" => time() + (int)$time,
+          "size" => (is_array($value) || is_object($value)) ? strlen(serialize($value)) : strlen((String)$value),
+        );
+
+        // handle search
+        if (isset($this->config[ 'allow_search' ]) && $this->config[ 'allow_search' ] == true) {
+            $option[ 'tags' ][] = "search";
+        }
+
+        // handle tags
+        if (isset($option[ 'tags' ])) {
+            $this->_handleTags($keyword, $time, $option[ 'tags' ]);
+        }
+
+        // handle method
+        if ((int)$this->config[ 'cache_method' ] > 1 && isset($object[ 'size' ]) && (int)$object[ 'size' ] <= (int)$this->config[ 'limited_memory_each_object' ]) {
+            CacheManager::$memory[ $this->config[ 'instance' ] ][ $keyword ] = $object;
+            if (in_array((int)$this->config[ 'cache_method' ], array(3, 4))) {
+                return true;
+            }
+        }
+        $this->_hit("set", 1);
+        return $this->driver_set($keyword, $object, $time, $option);
+
+    }
+
+    /**
+     * @param $keyword
+     * @param array $option
+     * @return mixed
+     */
+    public function get($keyword, $option = array())
+    {
+        /**
+         * Temporary disabled phpFastCache::$disabled = true
+         * Khoa. B
+         */
+
+        if (phpFastCache::$disabled === true) {
+            return null;
+        }
+
+        // handle method
+        if ((int)$this->config[ 'cache_method' ] > 1) {
+            if (isset(CacheManager::$memory[ $this->config[ 'instance' ] ][ $keyword ])) {
+                $object = CacheManager::$memory[ $this->config[ 'instance' ] ][ $keyword ];
+            }
+        }
+
+        if (!isset($object)) {
+            $this->_hit("get", 1);
+            $object = $this->driver_get($keyword, $option);
+
+            // handle method
+            if ((int)$this->config[ 'cache_method' ] > 1 && isset($object[ 'size' ]) && (int)$object[ 'size' ] <= (int)$this->config[ 'limited_memory_each_object' ]) {
+                CacheManager::$memory[ $this->config[ 'instance' ] ][ $keyword ] = $object;
+            }
+            // end handle method
+        }
+
+        if ($object == null) {
+            return null;
+        }
+
+        $value = isset($object[ 'value' ]) ? $object[ 'value' ] : null;
+        return isset($option[ 'all_keys' ]) && $option[ 'all_keys' ] ? $object : $value;
+    }
+
+    /**
+     * @param $keyword
+     * @param array $option
+     * @return null|object
+     */
+    public function getInfo($keyword, $option = array())
+    {
+        if ((int)$this->config[ 'cache_method' ] > 1) {
+            if (isset(CacheManager::$memory[ $this->config[ 'instance' ] ][ $keyword ])) {
+                $object = CacheManager::$memory[ $this->config[ 'instance' ] ][ $keyword ];
+            }
+        }
+        if (!isset($object)) {
+            $object = $this->driver_get($keyword, $option);
+        }
+        if ($object == null) {
+            return null;
+        }
+        return $object;
+    }
+
+    /**
+     * @param $keyword
+     * @param array $option
+     * @return mixed
+     */
+    public function delete($keyword, array $option = array())
+    {
+        // handle method
+        if ((int)$this->config[ 'cache_method' ] > 1) {
+            // use memory
+            unset(CacheManager::$memory[ $this->config[ 'instance' ] ][ $keyword ]);
+        }
+        // end handle method
+        return $this->driver_delete($keyword, $option);
+    }
+
+    /**
+     * @param array $option
+     * @return mixed
+     */
+    public function stats(array $option = array())
+    {
+        return $this->driver_stats($option);
+    }
+
+    /**
+     * @param array $option
+     * @return mixed
+     */
+    public function clean(array $option = array())
+    {
+        // handle method
+        if ((int)$this->config[ 'cache_method' ] > 1) {
+            // use memory
+            CacheManager::$memory[ $this->config[ 'instance' ] ] = array();
+        }
+        // end handle method
+        return $this->driver_clean($option);
+    }
+
+    /**
+     * @param $keyword
+     * @return bool
+     */
+    public function isExisting($keyword)
+    {
+        if (method_exists($this, 'driver_isExisting')) {
+            return $this->driver_isExisting($keyword);
+        }
+
+        $data = $this->get($keyword);
+        if ($data == null) {
+            return false;
+        } else {
+            return true;
+        }
+
+    }
+
+    /**
+     * Searches though the cache for keys that match the given query.
+     * @param $query_as_regex_or_string
+     * @param bool $search_in_value
+     * @return mixed
+     * @throws phpFastCacheDriverException
+     */
+    public function search($query_as_regex_or_string, $search_in_value = false)
+    {
+        if ($this->config[ 'allow_search' ] != true) {
+            throw new phpFastCacheDriverException('Please setup allow_search = true');
+        } else {
+            $list = $this->getTags("search", $search_in_value);
+            $tmp = explode("/", $query_as_regex_or_string, 2);
+            $regex = isset($tmp[ 1 ]) ? true : false;
+            $return_list = array();
+            foreach ($list as $tag) {
+                foreach ($tag as $keyword => $value) {
+                    $gotcha = false;
+                    if ($search_in_value == true) {
+                        $value = $this->get($keyword);
+                    }
+
+                    if ($regex == true && $gotcha == false) {     // look in keyword
+                        if (preg_match($query_as_regex_or_string, $keyword)) {
+                            $return_list[ $keyword ] = $value;
+                            $gotcha = true;
+                        }
+                    }
+                    if ($gotcha == false) {
+                        if (strpos($keyword, $query_as_regex_or_string) !== false) {
+                            $return_list[ $keyword ] = $value;
+                            $gotcha = true;
+                        }
+                    }
+
+                    if ($search_in_value == true && $gotcha == false) { // value search
+                        if ($regex == true && $gotcha == false) {
+                            if (preg_match($query_as_regex_or_string, $value)) {
+                                $return_list[ $keyword ] = $value;
+                                $gotcha = true;
+                            }
+                        }
+                        if ($gotcha == false) {
+                            if (strpos($value, $query_as_regex_or_string) !== false) {
+                                $return_list[ $keyword ] = $value;
+                                $gotcha = true;
+                            }
+                        }
+                    }
+                } // each tags loop
+            } // end foreach
+            return $return_list;
+        }
+    }
+
+    /**
+     * @param $keyword
+     * @param int $step
+     * @param array $option
+     * @return bool
+     */
+    public function increment($keyword, $step = 1, array $option = array())
+    {
+        $object = $this->get($keyword, array('all_keys' => true));
+        if ($object == null) {
+            return false;
+        } else {
+            $value = (int)$object[ 'value' ] + (int)$step;
+            $time = $object[ 'expired_time' ] - time();
+            $this->set($keyword, $value, $time, $option);
+            return true;
+        }
+    }
+
+    /**
+     * @param $keyword
+     * @param int $step
+     * @param array $option
+     * @return bool
+     */
+    public function decrement($keyword, $step = 1, array $option = array())
+    {
+        $object = $this->get($keyword, array('all_keys' => true));
+        if ($object == null) {
+            return false;
+        } else {
+            $value = (int)$object[ 'value' ] - (int)$step;
+            $time = $object[ 'expired_time' ] - time();
+            $this->set($keyword, $value, $time, $option);
+            return true;
+        }
+    }
+
+    /**
+     * Extend more time
+     * @param $keyword
+     * @param int $time
+     * @param array $option
+     * @return bool
+     */
+    public function touch($keyword, $time = 300, array $option = array())
+    {
+        $object = $this->get($keyword, array('all_keys' => true));
+        if ($object == null) {
+            return false;
+        } else {
+            $value = $object[ 'value' ];
+            $time = $object[ 'expired_time' ] - time() + $time;
+            $this->set($keyword, $value, $time, $option);
+            return true;
+        }
+    }
+
+
+    /**
+     * Other Functions Built-int for phpFastCache since 1.3
+     */
+
+    /**
+     * @param array $list
+     */
+    public function setMulti(array $list = array())
+    {
+        foreach ($list as $array) {
+            $this->set($array[ 0 ], isset($array[ 1 ]) ? $array[ 1 ] : 0,
+              isset($array[ 2 ]) ? $array[ 2 ] : array());
+        }
+    }
+
+    /**
+     * @param array $list
+     * @return array
+     */
+    public function getMulti(array $list = array())
+    {
+        $res = array();
+        foreach ($list as $array) {
+            $name = $array[ 0 ];
+            $res[ $name ] = $this->get($name,
+              isset($array[ 1 ]) ? $array[ 1 ] : array());
+        }
+        return $res;
+    }
+
+    /**
+     * @param array $list
+     * @return array
+     */
+    public function getInfoMulti(array $list = array())
+    {
+        $res = array();
+        foreach ($list as $array) {
+            $name = $array[ 0 ];
+            $res[ $name ] = $this->getInfo($name,
+              isset($array[ 1 ]) ? $array[ 1 ] : array());
+        }
+        return $res;
+    }
+
+    /**
+     * @param array $list
+     * @param array $option
+     */
+    public function deleteMulti(array $list = array(), array $option = array())
+    {
+        foreach ($list as $item) {
+            if (is_array($item) && count($item) === 2) {
+                $this->delete($item[ 0 ], $item[ 1 ]);
+            }
+        }
+    }
+
+    /**
+     * @param array $list
+     * @return array
+     */
+    public function isExistingMulti(array $list = array())
+    {
+        $res = array();
+        foreach ($list as $array) {
+            $name = $array[ 0 ];
+            $res[ $name ] = $this->isExisting($name);
+        }
+        return $res;
+    }
+
+    /**
+     * @param array $list
+     * @return array
+     */
+    public function incrementMulti(array $list = array())
+    {
+        $res = array();
+        foreach ($list as $array) {
+            $name = $array[ 0 ];
+            $res[ $name ] = $this->increment($name, $array[ 1 ],
+              isset($array[ 2 ]) ? $array[ 2 ] : array());
+        }
+        return $res;
+    }
+
+    /**
+     * @param array $list
+     * @return array
+     */
+    public function decrementMulti(array $list = array())
+    {
+        $res = array();
+        foreach ($list as $array) {
+            $name = $array[ 0 ];
+            $res[ $name ] = $this->decrement($name, $array[ 1 ],
+              isset($array[ 2 ]) ? $array[ 2 ] : array());
+        }
+        return $res;
+    }
+
+    /**
+     * @param array $list
+     * @return array
+     */
+    public function touchMulti(array $list = array())
+    {
+        $res = array();
+        foreach ($list as $array) {
+            $name = $array[ 0 ];
+            $res[ $name ] = $this->touch($name, $array[ 1 ],
+              isset($array[ 2 ]) ? $array[ 2 ] : array());
+        }
+        return $res;
+    }
+
+    /**
+     * @param $config_name
+     * @param string $value
+     */
+    public function setup($config_name, $value = '')
+    {
+        /*
+         * Config for class
+         */
+        if (is_array($config_name)) {
+            $this->config = array_merge($this->config, $config_name);
+        } else {
+            $this->config[ $config_name ] = $value;
+        }
+    }
+
+    /**
+     * @param int $time
+     */
+    public function autoCleanExpired($time = 3600)
+    {
+    }
+
+    /**
+     * Magic methods
+     */
+
+    /**
+     * @param $name
+     * @return mixed
+     */
+    public function __get($name)
+    {
+        return $this->get($name);
+    }
+
+    /**
+     * @param $name
+     * @param $v
+     * @return bool|null
+     * @throws \Exception
+     */
+    public function __set($name, $v)
+    {
+        if (isset($v[ 1 ]) && is_scalar($v[ 1 ])) {
+            return $this->set($name, $v[ 0 ], $v[ 1 ],
+              isset($v[ 2 ]) ? $v[ 2 ] : array());
+        } else {
+            throw new phpFastCacheDriverException("Example ->$name = array('VALUE', 300);", 98);
+        }
+    }
+
+
+    /**
+     * Base Methods
+     */
+
+
+    /**
+     * @return mixed
+     */
+    protected function backup()
+    {
+        return phpFastCache(phpFastCache::$config[ 'fallback' ]);
+    }
+
+    /**
+     * @param $name
+     * @return void
+     */
+    protected function required_extension($name)
+    {
+        require_once(__DIR__ . '/../' . $this->extension_dir . '/' . $name . '.' . PHP_EXT);
+    }
+
+
+    /**
+     * @param $file
+     * @return string
+     * @throws \Exception
+     */
+    protected function readfile($file)
+    {
+        if (function_exists('file_get_contents')) {
+            return file_get_contents($file);
+        } else {
+            $string = '';
+
+            $file_handle = @fopen($file, 'r');
+            if (!$file_handle) {
+                throw new phpFastCacheDriverException("Can't Read File", 96);
+
+            }
+            while (!feof($file_handle)) {
+                $line = fgets($file_handle);
+                $string .= $line;
+            }
+            fclose($file_handle);
+
+            return $string;
+        }
+    }
+
+    /**
+     * return PATH for Files & PDO only
+     * @param bool $create_path
+     * @return string
+     * @throws \Exception
+     */
+    public function getPath($create_path = false)
+    {
+        return phpFastCache::getPath($create_path, $this->config);
+    }
+
+
+    /**
+     *  Object for Files & SQLite
+     * @param $data
+     * @return string
+     */
+    protected function encode($data)
+    {
+        return serialize($data);
+    }
+
+    /**
+     * @param $value
+     * @return mixed
+     */
+    protected function decode($value)
+    {
+        $x = @unserialize($value);
+        if ($x == false) {
+            return $value;
+        } else {
+            return $x;
+        }
+    }
+
+    /**
+     * Check phpModules or CGI
+     * @return bool
+     */
+    protected function isPHPModule()
+    {
+        return phpFastCache::isPHPModule();
+    }
+
+
+    /**
+     * @param $class
+     * @return bool
+     */
+    protected function isExistingDriver($class)
+    {
+        return class_exists("\\phpFastCache\\Drivers\\{$class}");
+    }
+
+
+    /**
+     * @return int
+     */
+    protected function __setChmodAuto()
+    {
+        return phpFastCache::__setChmodAuto($this->config);
+    }
+
+
+    /**
+     * @param $tag
+     * @return string
+     */
+    protected function _getTagName($tag)
+    {
+        return "__tag__" . $tag;
+    }
+
+    /**
+     * @return \phpFastCache\Core\DriverAbstract
+     */
+    protected function _tagCaching()
+    {
+        return CacheManager::Sqlite(
+          array(
+            "path" => $this->config[ 'path' ],
+            "cache_method" => 3,
+          )
+        );
+    }
+
+    /**
+     * @param string $keyword
+     * @param mixed $value
+     * @param integer $time
+     * @param array $tags
+     * @param array $option | $option = array("tags" => array("a","b","c")
+     * @return mixed
+     */
+    public function setTags($keyword, $value = '', $time = 0, $tags = array(), $option = array())
+    {
+        if (!is_array($tags)) {
+            $tags = array($tags);
+        }
+        $option[ 'tags' ] = $tags;
+        return $this->set($keyword, $value, $time, $option);
+    }
+
+    protected function _handleTags($keyword, $time, $tags)
+    {
+        foreach ($tags as $tag) {
+            $list = $this->_tagCaching()->get($this->_getTagName($tag));
+            if (is_null($list)) {
+                $list = array();
+            }
+            $list[ $keyword ] = time() + $time;
+            $this->_tagCaching()->set($this->_getTagName($tag), $list, 3600 * 24 * 30);
+        }
+    }
+
+
+    /**
+     * @param array $tags
+     * @param bool $return_content
+     * @param array $option | $option = array("tags" => array("a","b","c")
+     * @return array
+     */
+    public function getTags($tags = array(), $return_content = true, $option = array())
+    {
+        if (!is_array($tags)) {
+            $tags = array($tags);
+        }
+        $keywords = array();
+        $tmp = 0;
+
+        foreach ($tags as $tag) {
+            $list = $this->_tagCaching()->get($this->_getTagName($tag));
+            $list_return = array();
+            if (is_null($list)) {
+                $list = array();
+            }
+            foreach ($list as $keyword => $time) {
+                if ($time <= time()) {
+                    unset($list[ $keyword ]);
+                } else {
+                    if ($tmp < $time) {
+                        $tmp = $time;
+                    }
+                    if ($return_content == true) {
+                        $list_return[ $keyword ] = $this->get($keyword);
+                    } else {
+                        $list_return[ $keyword ] = $time;
+                    }
+                }
+            }
+
+            $this->_tagCaching()->set($this->_getTagName($tag), $list, $tmp);
+            $keywords[ $tag ] = $list_return;
+        }
+        return $keywords;
+    }
+
+    /**
+     * @param array $tags | array("a","b","c")
+     * @param int $time
+     * @param array $options
+     * @return mixed
+     * @internal param array $option | $option = array("tags" => array("a","b","c")
+     */
+    public function touchTags($tags = array(), $time = 300, $options = array())
+    {
+        if (!is_array($tags)) {
+            $tags = array($tags);
+        }
+        $lists = $this->getTags($tags);
+        foreach ($lists as $tag => $keywords) {
+            foreach ($keywords as $keyword => $time) {
+                $this->touch($keyword, $time, $options);
+            }
+        }
+        return true;
+    }
+
+    /**
+     * @param array $tags | array("a","b","c")
+     * @param array $option | $option = array("tags" => array("a","b","c")
+     * @return mixed
+     */
+    public function deleteTags($tags = array(), $option = array())
+    {
+        if (!is_array($tags)) {
+            $tags = array($tags);
+        }
+        $lists = $this->getTags($tags);
+        foreach ($lists as $tag => $keywords) {
+            foreach ($keywords as $keyword => $time) {
+                $this->delete($keyword, $option);
+            }
+        }
+        return true;
+    }
+
+
+    /**
+     * @param array $tags | array("a","b","c")
+     * @param integer
+     * @param array $option | $option = array("tags" => array("a","b","c")
+     * @return mixed
+     */
+    public function incrementTags($tags = array(), $step = 1, $option = array())
+    {
+        if (!is_array($tags)) {
+            $tags = array($tags);
+        }
+        $lists = $this->getTags($tags);
+        foreach ($lists as $tag => $keywords) {
+            foreach ($keywords as $keyword => $time) {
+                $this->increment($keyword, $step, $option);
+            }
+        }
+        return true;
+    }
+
+    /**
+     * @param array $tags | array("a","b","c")
+     * @param integer
+     * @param array $option | $option = array("tags" => array("a","b","c")
+     * @return mixed
+     */
+    public function decrementTags($tags = array(), $step = 1, $option = array())
+    {
+        if (!is_array($tags)) {
+            $tags = array($tags);
+        }
+        $lists = $this->getTags($tags);
+        foreach ($lists as $tag => $keywords) {
+            foreach ($keywords as $keyword => $time) {
+                $this->decrement($keyword, $step, $option);
+            }
+        }
+        return true;
+    }
+
+    /**
+     * @param $value
+     */
+    protected function _kbdebug($value)
+    {
+        /*
+        echo "<pre>";
+        print_r($value);
+        echo "</pre>";
+        */
+    }
+
+    public function _hit($index, $step = 1)
+    {
+        $instance = $this->config[ 'instance' ];
+        $current = isset(CacheManager::$hit[ $instance ][ 'data' ][ $index ]) ? CacheManager::$hit[ $instance ][ 'data' ][ $index ] : 0;
+        CacheManager::$hit[ $instance ][ 'data' ][ $index ] = $current + ($step);
+    }
+
+}
--- a/lib/phpfastcache/phpFastCache/Core/DriverInterface.php
+++ b/lib/phpfastcache/phpFastCache/Core/DriverInterface.php
@ -0,0 +1,86 @@
+<?php
+/**
+ *
+ * This file is part of phpFastCache.
+ *
+ * @license MIT License (MIT)
+ *
+ * For full copyright and license information, please see the docs/CREDITS.txt file.
+ *
+ * @author Khoa Bui (khoaofgod)  <khoaofgod@gmail.com> http://www.phpfastcache.com
+ * @author Georges.L (Geolim4)  <contact@geolim4.com>
+ *
+ */
+
+namespace phpFastCache\Core;
+
+/**
+ * Interface DriverInterface
+ * @package phpFastCache\Core
+ */
+interface DriverInterface
+{
+    /**
+     * Check if this Cache driver is available for server or not
+     * phpFastCache_driver constructor.
+     * @param array $config
+     */
+    public function __construct($config = array());
+
+    /**
+     * @return mixed
+     */
+    public function checkdriver();
+
+    /**
+     * Set a obj to cache
+     * @param $keyword
+     * @param string $value
+     * @param int $time
+     * @param array $option
+     * @return mixed
+     */
+    public function driver_set(
+      $keyword,
+      $value = '',
+      $time = 300,
+      $option = array()
+    );
+
+    /**
+     * Return null or value of cache
+     * @param $keyword
+     * @param array $option
+     * @return mixed
+     */
+    public function driver_get($keyword, $option = array());
+
+    /**
+     * Show stats of caching
+     * Return array("info","size","data")
+     * @param array $option
+     * @return mixed
+     */
+    public function driver_stats($option = array());
+
+    /**
+     * Delete a cache
+     * @param $keyword
+     * @param array $option
+     * @return mixed
+     */
+    public function driver_delete($keyword, $option = array());
+
+    /**
+     * Clean up whole cache
+     * @param array $option
+     * @return mixed
+     */
+    public function driver_clean($option = array());
+
+    /**
+     * @param $config_name
+     * @param string $value
+     */
+    public function setup($config_name, $value = '');
+}
--- a/lib/phpfastcache/phpFastCache/Core/phpFastCache.php
+++ b/lib/phpfastcache/phpFastCache/Core/phpFastCache.php
@ -0,0 +1,354 @@
+<?php
+/**
+ *
+ * This file is part of phpFastCache.
+ *
+ * @license MIT License (MIT)
+ *
+ * For full copyright and license information, please see the docs/CREDITS.txt file.
+ *
+ * @author Khoa Bui (khoaofgod)  <khoaofgod@gmail.com> http://www.phpfastcache.com
+ * @author Georges.L (Geolim4)  <contact@geolim4.com>
+ *
+ */
+
+namespace phpFastCache\Core;
+
+use phpFastCache\CacheManager;
+use phpFastCache\Exceptions\phpFastCacheCoreException;
+use phpFastCache\Exceptions\phpFastCacheDriverException;
+
+/**
+ * Class phpFastCache
+ * @package phpFastCache\Core
+ *
+ * Handle methods using annotations for IDE
+ * because they're handled by __call()
+ * Check out DriverInterface to see all
+ * the drivers methods magically implemented
+ *
+ * @method get() driver_get($keyword, $option = array()) Return null or value of cache
+ * @method set() driver_set($keyword, $value = '', $time = 300, $option = array()) Set a obj to cache
+ * @method delete() delete(string $keyword) Delete key from cache
+ * @method clean() clean($option = array()) Clean up whole cache
+ * @method checkdriver() checkdriver() Delete key from cache
+ * @method stats() stats($option = array()) Show stats of caching
+ * @method systemInfo() systemInfo() Return System Information
+ *
+ */
+class phpFastCache
+{
+    /**
+     * @var bool
+     */
+    public static $disabled = false;
+
+    /**
+     * @var array
+     */
+    public static $config = array(
+      'storage' => '', // blank for auto
+      'default_chmod' => 0777, // 0777 , 0666, 0644
+
+      'overwrite'  =>  "", // files, sqlite, etc it will overwrite ur storage and all other caching for waiting u fix ur server
+      'allow_search'   =>  false, // turn to true will allow $method search("/regex/")
+
+      'fallback' => 'files', //Fall back when old driver is not support
+
+      'securityKey' => 'auto',
+      'htaccess' => true,
+      'path' => '',
+
+      'memcache' => array(
+        array('127.0.0.1', 11211, 1),
+          //  array("new.host.ip",11211,1),
+      ),
+
+      'redis' => array(
+        'host' => '127.0.0.1',
+        'port' => '',
+        'password' => '',
+        'database' => '',
+        'timeout' => '',
+      ),
+
+      'ssdb' => array(
+        'host' => '127.0.0.1',
+        'port' => 8888,
+        'password' => '',
+        'timeout' => '',
+      ),
+
+      'extensions' => array(),
+      "cache_method"    =>  1, // 1 = normal, 2 = phpfastcache, 3 = memory
+      "limited_memory_each_object"  =>  4000, // maximum size (bytes) of object store in memory
+      "compress_data" => false // compress stored data, if the backend supports it
+    );
+
+    /**
+     * @var array
+     */
+    protected static $tmp = array();
+
+    /**
+     * @var DriverAbstract $instance
+     */
+    public $instance;
+
+    /**
+     * phpFastCache constructor.
+     * @param string $storage
+     * @param array $config
+     */
+    public function __construct($storage = '', $config = array())
+    {
+        if (empty($config)) {
+            $config = phpFastCache::$config;
+        }
+        $config[ 'storage' ] = $storage;
+
+        $storage = strtolower($storage);
+        if ($storage == '' || $storage == 'auto') {
+            $storage = self::getAutoClass($config);
+        }
+
+        $this->instance = CacheManager::getInstance($storage, $config);
+    }
+
+    /**
+     * Cores
+     */
+
+    /**
+     * @param $config
+     * @return string
+     * @throws \Exception
+     */
+    public static function getAutoClass($config)
+    {
+        $path = self::getPath(false, $config);
+        if (is_writable($path)) {
+            $driver = 'files';
+        } else if (extension_loaded('apc') && ini_get('apc.enabled') && strpos(PHP_SAPI, 'CGI') === false) {
+            $driver = 'apc';
+        } else if (class_exists('memcached')) {
+            $driver = 'memcached';
+        } elseif (extension_loaded('wincache') && function_exists('wincache_ucache_set')) {
+            $driver = 'wincache';
+        } elseif (extension_loaded('xcache') && function_exists('xcache_get')) {
+            $driver = 'xcache';
+        } else if (function_exists('memcache_connect')) {
+            $driver = 'memcache';
+        } else if (class_exists('Redis')) {
+            $driver = 'redis';
+        } else {
+            $driver = 'files';
+        }
+
+        return $driver;
+    }
+
+    /**
+     * @param bool $skip_create_path
+     * @param $config
+     * @return string
+     * @throws \Exception
+     */
+    public static function getPath($skip_create_path = false, $config)
+    {
+        $tmp_dir = ini_get('upload_tmp_dir') ? ini_get('upload_tmp_dir') : sys_get_temp_dir();
+
+        if (!isset($config[ 'path' ]) || $config[ 'path' ] == '') {
+            if (self::isPHPModule()) {
+                $path = $tmp_dir;
+            } else {
+                $document_root_path = rtrim($_SERVER[ 'DOCUMENT_ROOT' ], '/') . '/../';
+                $path = isset($_SERVER[ 'DOCUMENT_ROOT' ]) && is_writable($document_root_path)
+                    ? $document_root_path
+                    : rtrim(__DIR__, '/') . '/';
+            }
+
+            if (self::$config[ 'path' ] != '') {
+                $path = $config[ 'path' ];
+            }
+
+        } else {
+            $path = $config[ 'path' ];
+        }
+
+        $securityKey = array_key_exists('securityKey',
+          $config) ? $config[ 'securityKey' ] : '';
+        if ($securityKey == "" || $securityKey == 'auto') {
+            $securityKey = self::$config[ 'securityKey' ];
+            if ($securityKey == 'auto' || $securityKey == '') {
+                $securityKey = isset($_SERVER[ 'HTTP_HOST' ]) ? preg_replace('/^www./',
+                  '', strtolower(str_replace(':', '_', $_SERVER[ 'HTTP_HOST' ]))) : "default";
+            }
+        }
+        if ($securityKey != '') {
+            $securityKey .= '/';
+        }
+
+        $securityKey = self::cleanFileName($securityKey);
+
+        $full_path = rtrim($path,'/') . '/' . $securityKey;
+        $full_pathx = md5($full_path);
+
+
+        if ($skip_create_path == false && !isset(self::$tmp[ $full_pathx ])) {
+
+            if (!@file_exists($full_path) || !@is_writable($full_path)) {
+                if (!@file_exists($full_path)) {
+                    @mkdir($full_path, self::__setChmodAuto($config), true);
+                }
+                if (!@is_writable($full_path)) {
+                    @chmod($full_path, self::__setChmodAuto($config));
+                }
+                if(!@is_writable($full_path)) {
+                    // switch back to tmp dir again if the path is not writeable
+                    $full_path = rtrim($tmp_dir,'/') . '/' . $securityKey;
+                    if (!@file_exists($full_path)) {
+                        @mkdir($full_path, self::__setChmodAuto($config), true);
+                    }
+                    if (!@is_writable($full_path)) {
+                        @chmod($full_path, self::__setChmodAuto($config));
+                    }
+                }
+                if (!@file_exists($full_path) || !@is_writable($full_path)) {
+                    throw new phpFastCacheCoreException('PLEASE CREATE OR CHMOD ' . $full_path . ' - 0777 OR ANY WRITABLE PERMISSION!', 92);
+                }
+            }
+
+            self::$tmp[ $full_pathx ] = true;
+            self::htaccessGen($full_path, array_key_exists('htaccess', $config) ? $config[ 'htaccess' ] : false);
+        }
+
+        return realpath($full_path);
+
+    }
+
+    /**
+     * @param $filename
+     * @return mixed
+     */
+    public static function cleanFileName($filename)
+    {
+        $regex = array(
+          '/[\?\[\]\/\\\=\<\>\:\;\,\'\"\&\$\#\*\(\)\|\~\`\!\{\}]/',
+          '/\.$/',
+          '/^\./',
+        );
+        $replace = array('-', '', '');
+        return trim(preg_replace($regex, $replace, trim($filename)),'-');
+    }
+
+    /**
+     * @param $config
+     * @return int
+     */
+    public static function __setChmodAuto($config)
+    {
+        if (!isset($config[ 'default_chmod' ]) || $config[ 'default_chmod' ] == '' || is_null($config[ 'default_chmod' ])) {
+            return 0777;
+        } else {
+            return $config[ 'default_chmod' ];
+        }
+    }
+
+    /**
+     * @return array
+     */
+    protected static function getOS()
+    {
+        $os = array(
+          'os' => PHP_OS,
+          'php' => PHP_SAPI,
+          'system' => php_uname(),
+          'unique' => md5(php_uname() . PHP_OS . PHP_SAPI),
+        );
+        return $os;
+    }
+
+    /**
+     * @return bool
+     */
+    public static function isPHPModule()
+    {
+        if (PHP_SAPI === 'apache2handler') {
+            return true;
+        } else {
+            if (strpos(PHP_SAPI, 'handler') !== false) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * @param $path
+     * @param bool $create
+     * @throws \Exception
+     */
+    protected static function htaccessGen($path, $create = true)
+    {
+
+        if ($create == true) {
+            if (!is_writable($path)) {
+                try {
+                    chmod($path, 0777);
+                } catch (phpFastCacheDriverException $e) {
+                    throw new phpFastCacheDriverException('PLEASE CHMOD ' . $path . ' - 0777 OR ANY WRITABLE PERMISSION!',
+                      92);
+                }
+            }
+
+            if(!file_exists($path."/.htaccess")) {
+                //   echo "write me";
+                $html = "order deny, allow \r\n
+deny from all \r\n
+allow from 127.0.0.1";
+
+                $f = @fopen($path . '/.htaccess', 'w+');
+                if (!$f) {
+                    throw new phpFastCacheDriverException('PLEASE CHMOD ' . $path . ' - 0777 OR ANY WRITABLE PERMISSION!', 92);
+                }
+                fwrite($f, $html);
+                fclose($f);
+
+
+            }
+        }
+
+    }
+
+    /**
+     * @param $name
+     * @param string $value
+     */
+    public static function setup($name, $value = '')
+    {
+        if (is_array($name)) {
+            self::$config = array_merge(self::$config,$name);
+        } else {
+            self::$config[ $name ] = $value;
+        }
+    }
+
+    /**
+     * @param $something
+     */
+    public static function debug($something)
+    {
+        echo "Starting Debugging ...<br>\r\n ";
+        if (is_array($something)) {
+            echo '<pre>';
+            print_r($something);
+            echo '</pre>';
+            var_dump($something);
+        } else {
+            echo $something;
+        }
+        echo "\r\n<br> Ended";
+        exit;
+    }
+}
--- a/lib/phpfastcache/phpFastCache/Core/phpFastCacheExtensions.php
+++ b/lib/phpfastcache/phpFastCache/Core/phpFastCacheExtensions.php
@ -0,0 +1,31 @@
+<?php
+/**
+ *
+ * This file is part of phpFastCache.
+ *
+ * @license MIT License (MIT)
+ *
+ * For full copyright and license information, please see the docs/CREDITS.txt file.
+ *
+ * @author Khoa Bui (khoaofgod)  <khoaofgod@gmail.com> http://www.phpfastcache.com
+ * @author Georges.L (Geolim4)  <contact@geolim4.com>
+ *
+ */
+
+namespace phpFastCache\Core;
+
+/**
+ * Class phpFastCacheExtensions
+ * @package phpFastCache\Core
+ */
+abstract class phpFastCacheExtensions
+{
+    /**
+     * @param $name
+     * @param $agr
+     */
+    public function __call($name, $agr)
+    {
+
+    }
+}