[李景山php]thinkphp核心源码注释|Memcached.class.php

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

namespace Think\Cache\Driver;

use Memcached as MemcachedResource;
use Think\Cache;

/**
 * Memcached缓存驱动
 * 感觉这个像是个服务器 分布式 服务器版本
 */
class Memcached extends Cache {

    /**
     * 统一的初始化，不一样的 开始，嘿嘿
     * @param array $options
     */
    public function __construct($options = array()) {
        if ( !extension_loaded('memcached') ) {
            E(L('_NOT_SUPPORT_').':memcached');
        }

        $options = array_merge(array(
            'servers'       =>  C('MEMCACHED_SERVER') ? : null,
            'lib_options'   =>  C('MEMCACHED_LIB') ? : null
        ), $options); // 这个合并真心好用

        $this->options      =   $options;
        $this->options['expire'] =  isset($options['expire'])?  $options['expire']  :   C('DATA_CACHE_TIME');
        $this->options['prefix'] =  isset($options['prefix'])?  $options['prefix']  :   C('DATA_CACHE_PREFIX');
        $this->options['length'] =  isset($options['length'])?  $options['length']  :   0;

        $this->handler      =   new MemcachedResource; // 变更具体的操作者
        $options['servers'] && $this->handler->addServers($options['servers']);
        $options['lib_options'] && $this->handler->setOptions($options['lib_options']);
    }

    /**
     * 读取缓存
     * @access public
     * @param string $name 缓存变量名
     * @return mixed
     * 封装没什么意思
     */
    public function get($name) {
        N('cache_read',1);
        return $this->handler->get($this->options['prefix'].$name);
    }

    /**
     * 写入缓存
     * @access public
     * @param string $name 缓存变量名
     * @param mixed $value  存储数据
     * @param integer $expire  有效时间（秒）
     * @return boolean
     */
    public function set($name, $value, $expire = null) {
        N('cache_write',1);// 记录次数
        if(is_null($expire)) {
            $expire  =  $this->options['expire'];
        }
        $name   =   $this->options['prefix'].$name;
        if($this->handler->set($name, $value, time() + $expire)) {
            if($this->options['length']>0) {
                // 记录缓存队列
                $this->queue($name); // 排队列
            }
            return true;
        }
        return false;
    }

    /**
     * 删除缓存
     * @access public
     * @param string $name 缓存变量名
     * @return boolean
     * 单条删除
     */
    public function rm($name, $ttl = false) {
        $name   =   $this->options['prefix'].$name;
        return $ttl === false ?
        $this->handler->delete($name) :
        $this->handler->delete($name, $ttl);
    }

    /**
     * 清除缓存
     * @access public
     * @return boolean
     * 清空缓存 清除掉一切
     */
    public function clear() {
        return $this->handler->flush();
    }
}