每天laravel-20160625|RedisStore

<?php

namespace Illuminate\Cache;

use Illuminate\Contracts\Cache\Store;
use Illuminate\Redis\Database as Redis;
// a namespace to enough
class RedisStore extends TaggableStore implements Store
{// a Store about use in Redis
/**
* The Redis database connection.
*
* @var \Illuminate\Redis\Database
*/
protected $redis;// The Redis database connection,it is a connection instance
// a instance about redis

/**
* A string that should be prepended to keys.
*
* @var string
*/
protected $prefix;// a prefix key, it is a string that should be prepended to keys.

/**
* The Redis connection that should be used.
*
* @var string
*/
protected $connection;// a connection to redis,
// The Redis connection that should be used.

/**
* Create a new Redis store.
*
* @param  \Illuminate\Redis\Database  $redis
* @param  string  $prefix
* @param  string  $connection
* @return void
*/
public function __construct(Redis $redis, $prefix = '', $connection = 'default')
{
$this->redis = $redis;
$this->setPrefix($prefix);
$this->connection = $connection;
}// Create a new Redis store.
// set a big data, new a instance, set a prefix, a connection way or a type

/**
* Retrieve an item from the cache by key.
*
* @param  string|array  $key
* @return mixed
*/
public function get($key)
{
if (! is_null($value = $this->connection()->get($this->prefix.$key))) {
return is_numeric($value) ? $value : unserialize($value);
}
}// Retrieve an item from the cache by key.
// get value by key.

/**
* Retrieve multiple items from the cache by key.
* get many items by key. from the cache
* Items not found in the cache will have a null value.
* can't found , so  back a null value.
* @param  array  $keys
* @return array
*/
public function many(array $keys)
{
$return = [];// a store array

$prefixedKeys = array_map(function ($key) {
return $this->prefix.$key;
}, $keys);// get keys by key and prefix from the array_map method.

$values = $this->connection()->mget($prefixedKeys);// get a value by keys array

foreach ($values as $index => $value) {
$return[$keys[$index]] = is_numeric($value) ? $value : unserialize($value);
}// reset $values to $return , check is a number

return $return;
}// get a lots of value from cache by keys.

/**
* Store an item in the cache for a given number of minutes.
*
* @param  string  $key
* @param  mixed   $value
* @param  int     $minutes
* @return void
*/
public function put($key, $value, $minutes)// Store an item in the cache for a given number of minutes
{
$value = is_numeric($value) ? $value : serialize($value);// set number or string

$minutes = max(1, $minutes);// set minutes not a second

$this->connection()->setex($this->prefix.$key, $minutes * 60, $value);// use a api function
}// put a values to cache minutes

/**
* Store multiple items in the cache for a given number of minutes.
*
* @param  array  $values
* @param  int  $minutes
* @return void
*/
public function putMany(array $values, $minutes)// Store multiple items in the cache for a given number of minutes.
{
$this->connection()->multi();// set multi method

foreach ($values as $key => $value) {
$this->put($key, $value, $minutes);// use a put method
}

$this->connection()->exec();// to  done
}

/**
* Increment the value of an item in the cache.
*
* @param  string  $key
* @param  mixed   $value
* @return int
*/
public function increment($key, $value = 1)// Increment the value of an item in the cache.
{
return $this->connection()->incrby($this->prefix.$key, $value);
}// use api to increment

/**
* Decrement the value of an item in the cache.
*
* @param  string  $key
* @param  mixed   $value
* @return int
*/
public function decrement($key, $value = 1)// Decrement the value of an item in the cache.
{
return $this->connection()->decrby($this->prefix.$key, $value);// a de crby  is a api
}

/**
* Store an item in the cache indefinitely.
*
* @param  string  $key
* @param  mixed   $value
* @return void
*/
public function forever($key, $value)// Store an item in the cache indefinitely.
{
$value = is_numeric($value) ? $value : serialize($value);// $value is check

$this->connection()->set($this->prefix.$key, $value);// set a keys and values
}

/**
* Remove an item from the cache.
*
* @param  string  $key
* @return bool
*/
public function forget($key)
{
return (bool) $this->connection()->del($this->prefix.$key);
}// Remove an item from the cache. use a api method del

/**
* Remove all items from the cache.
*
* @return void
*/
public function flush()
{
$this->connection()->flushdb();// use api
}// Remove all items from the cache.

/**
* Begin executing a new tags operation.
*
* @param  array|mixed  $names
* @return \Illuminate\Cache\RedisTaggedCache
*/
public function tags($names)// begin executing a new tags
{
return new RedisTaggedCache($this, new TagSet($this, is_array($names) ? $names : func_get_args()));
}// a new tags

/**
* Get the Redis connection instance.
*
* @return \Predis\ClientInterface
*/
public function connection()// Get the redis connection instance.
{
return $this->redis->connection($this->connection);// this is a connection to connection redis
}

/**
* Set the connection name to be used.
*
* @param  string  $connection
* @return void
*/
public function setConnection($connection)
{
$this->connection = $connection;
}// Set the connection name to be used. a big set

/**
* Get the Redis database instance.
*
* @return \Illuminate\Redis\Database
*/
public function getRedis()
{
return $this->redis;
}// Get the Redis database instance.
// a big __get

/**
* Get the cache key prefix.
*
* @return string
*/
public function getPrefix()
{
return $this->prefix;
}// Get the cache key prefix.

/**
* Set the cache key prefix.
*
* @param  string  $prefix
* @return void
*/
public function setPrefix($prefix)
{
$this->prefix = ! empty($prefix) ? $prefix.':' : '';
}// Set the cache key prefix.
}