<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2016 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------

namespace think;

use think\App;
// 缓存文件 处理,此处是 thinkphp 库文件,怎么能用thinkphp文件呢

class Cache
{
    protected static $instance = [];// 受保护 静态的 实例化句柄 数组
    public static $readTimes   = 0;//读时间
    public static $writeTimes  = 0;// 写入时间

    /**
     * 操作句柄
     * @var object
     * @access protected
     */
    protected static $handler;// 当前操作 句柄 受保护的 静态的

    /**
     * 连接缓存
     * @access public
     * @param array         $options  配置数组
     * @param bool|string   $name 缓存连接标识 true 强制重新连接
     * @return \think\cache\Driver
     */
    public static function connect(array $options = [], $name = false)
    {// 连接缓存 处理装置
        // 参数 配置 数组, 强制重新连接 标志位
        $type = !empty($options['type']) ? $options['type'] : 'File';// 默认缓存数据类型,文件
        if (false === $name) {//如果没有传入文件名,缓存实例化 文件名
            $name = md5(serialize($options));
        }// 创造一个

        if (true === $name || !isset(self::$instance[$name])) {// 当强制重新连接的时候,或者 没有设置当前连接属性的时候
            $class = false !== strpos($type, '\\') ? $type : '\\think\\cache\\driver\\' . ucwords($type);// 生成对应的类名

            // 记录初始化信息
            App::$debug && Log::record('[ CACHE ] INIT ' . $type, 'info');// 如果开启调试信息,就记录开始信息
            if (true === $name) {// 如果 强制重新初始化
                return new $class($options);// 返回新的 实例化数组 全部重新来过 实例化 之后不存储而已
            } else {
                self::$instance[$name] = new $class($options);// 否则 部分 初始化
            }
        }
        self::$handler = self::$instance[$name];//把建立的实例化 存起来
        return self::$handler;// 返回句柄
    }// connect 实际的目的就是 return new $class($option) 如果是true 不存, flase 就存到 $instance[$name]里面

    /**
     * 自动初始化缓存
     * @access public
     * @param array         $options  配置数组
     * @return void
     */
    public static function init(array $options = [])
    {
        if (is_null(self::$handler)) {// 如果当前没有呗使用的 对象 ,就处理,否则 什么事情都不做
            // 自动初始化缓存
            if (!empty($options)) {// 选项不为空
                self::connect($options);
            } elseif ('complex' == Config::get('cache.type')) {// 特殊类型
                self::connect(Config::get('cache.default'));// 选项 获取
            } else {// 获取默认选项
                self::connect(Config::get('cache'));
            }// 总之,就是跟句不同的选项进行 实例化, 此处为公共的 静态 函数,也就意味这外部是可以调用的
        }
    }// 自动初始化,

    /**
     * 切换缓存类型 需要配置 cache.type 为 complex
     * @access public
     * @param string $name 缓存标识
     * @return \think\cache\Driver
     */
    public static function store($name)
    {
        if ('complex' == Config::get('cache.type')) {// 如果 类型 特殊,重新设置
            self::connect(Config::get('cache.' . $name), strtolower($name));
        }// 只有这样的情况下,才能完成切换,否则是不行的
        return self::$handler;
    }// 切换缓存 句柄

    /**
     * 判断缓存是否存在
     * @access public
     * @param string $name 缓存变量名
     * @return bool
     */
    public static function has($name)
    {
        self::init();// 初始化
        self::$readTimes++;//读取次数加一
        return self::$handler->has($name);// 通过注入后的class 查找是否包含这个数据
    }// 判读当前缓存是否存在

    /**
     * 读取缓存
     * @access public
     * @param string $name 缓存标识
     * @param mixed  $default 默认值
     * @return mixed
     */
    public static function get($name, $default = false)
    {
        self::init();
        self::$readTimes++;
        return self::$handler->get($name, $default);
    }// 外包读取缓存, 静态方式

    /**
     * 写入缓存
     * @access public
     * @param string        $name 缓存标识
     * @param mixed         $value  存储数据
     * @param int|null      $expire  有效时间 0为永久
     * @return boolean
     */
    public static function set($name, $value, $expire = null)
    {
        self::init();
        self::$writeTimes++;
        return self::$handler->set($name, $value, $expire);
    }//外包写入,静态方法

    /**
     * 自增缓存(针对数值缓存)
     * @access public
     * @param string    $name 缓存变量名
     * @param int       $step 步长
     * @return false|int
     */
    public static function inc($name, $step = 1)
    {
        self::init();
        self::$writeTimes++;
        return self::$handler->inc($name, $step);
    }// 自增

    /**
     * 自减缓存(针对数值缓存)
     * @access public
     * @param string    $name 缓存变量名
     * @param int       $step 步长
     * @return false|int
     */
    public static function dec($name, $step = 1)
    {
        self::init();
        self::$writeTimes++;
        return self::$handler->dec($name, $step);
    }

    /**
     * 删除缓存
     * @access public
     * @param string    $name 缓存标识
     * @return boolean
     */
    public static function rm($name)
    {
        self::init();
        self::$writeTimes++;
        return self::$handler->rm($name);
    }

    /**
     * 清除缓存
     * @access public
     * @param string $tag 标签名
     * @return boolean
     */
    public static function clear($tag = null)
    {
        self::init();
        self::$writeTimes++;
        return self::$handler->clear($tag);
    }

    /**
     * 缓存标签
     * @access public
     * @param string        $name 标签名
     * @param string|array  $keys 缓存标识
     * @param bool          $overlay 是否覆盖
     * @return \think\cache\Driver
     */
    public static function tag($name, $keys = null, $overlay = false)
    {
        self::init();
        return self::$handler->tag($name, $keys, $overlay);
    }// 标签获取

}