<?php
namespace Illuminate\Cache;
use Memcached;
use Illuminate\Contracts\Cache\Store;
// a namespace about the user
class MemcachedStore extends TaggableStore implements Store
{// a Store about Memcache Store
/**
* The Memcached instance.
* The Memcached instance.
* @var \Memcached
*/
protected $memcached;
/**
* A string that should be prepended to keys.
* A string that should be prepended to keys.
* @var string
*/
protected $prefix;// a string about the prefix. with connection about the
/**
* Create a new Memcached store.
* Create a new Memcached store.
* @param \Memcached $memcached
* @param string $prefix
* @return void
*/
public function __construct($memcached, $prefix = '')
{
$this->setPrefix($prefix);
$this->memcached = $memcached;
}// a supper big prefix
/**
* Retrieve an item from the cache by key.
* Retrieve an item form the cache by key.
* @param string|array $key
* @return mixed
*/
public function get($key)
{
$value = $this->memcached->get($this->prefix.$key);// a way to get value
if ($this->memcached->getResultCode() == 0) {
return $value;
}// if return value,
}// get a method
/**
* Retrieve multiple items from the cache by key.
* Retrieve multiple items from the cache by key.
*
* Items not found in the cache will have a null value.
* Items not found in the cache will have a null value.
* @param array $keys
* @return array
*/
public function many(array $keys)
{
$prefixedKeys = array_map(function ($key) {
return $this->prefix.$key;
}, $keys);// you are master ,
$values = $this->memcached->getMulti($prefixedKeys, null, Memcached::GET_PRESERVE_ORDER);
// more get
if ($this->memcached->getResultCode() != 0) {
return array_fill_keys($keys, null);
}// get the result
return array_combine($keys, $values);
}// get a lot of keys
/**
* Store an item in the cache for a given number of minutes.
* 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)
{
$this->memcached->set($this->prefix.$key, $value, $minutes * 60);
}// a normal method ,put like push,set,
/**
* Store multiple items in the cache for a given number of 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)
{
$prefixedValues = [];// set a value array
foreach ($values as $key => $value) {
$prefixedValues[$this->prefix.$key] = $value;
}// to control a new array t
$this->memcached->setMulti($prefixedValues, $minutes * 60);// change time to second
}// the method is putMany
/**
* Store an item in the cache if the key doesn't exist.
* Store an item in the cache if the key doesn't exist.
* @param string $key
* @param mixed $value
* @param int $minutes
* @return bool
*/
public function add($key, $value, $minutes)
{
return $this->memcached->add($this->prefix.$key, $value, $minutes * 60);
}// add ,increment , first to check,is has
/**
* Increment the value of an item in the cache.
* Increment the value of an item in the cache.
* @param string $key
* @param mixed $value
* @return int|bool
*/
public function increment($key, $value = 1)
{
return $this->memcached->increment($this->prefix.$key, $value);
}// a wrapper to increment.
/**
* Decrement the value of an item in the cache.
* Decrement the value of an item in the cache.
* @param string $key
* @param mixed $value
* @return int|bool
*/
public function decrement($key, $value = 1)
{
return $this->memcached->decrement($this->prefix.$key, $value);
}// a wrapper to memcached to decrement
/**
* Store an item in the cache indefinitely.
* Store an item in the cache indefinitely.
* @param string $key
* @param mixed $value
* @return void
*/
public function forever($key, $value)
{
$this->put($key, $value, 0);
}// forever to set a long time,never expired, ten 9
/**
* Remove an item from the cache.
* Remove an item from the cache.
* @param string $key
* @return bool
*/
public function forget($key)
{
return $this->memcached->delete($this->prefix.$key);
}// ro make time to expired
/**
* Remove all items from the cache.
*
* @return void
*/
public function flush()
{
$this->memcached->flush();
}// remove all item from the cache. a flush to refresh
/**
* Get the underlying Memcached connection.
* Get the underlying Memcached connection.
* @return \Memcached
*/
public function getMemcached()
{
return $this->memcached;
}// back the instance about the memcached
/**
* Get the cache key prefix.
* Get the cache key prefix.
* @return string
*/
public function getPrefix()
{
return $this->prefix;
}// back a prefix
/**
* Set the cache key prefix.
* Set the cache key prefix.
* @param string $prefix
* @return void
*/
public function setPrefix($prefix)
{
$this->prefix = ! empty($prefix) ? $prefix.':' : '';
}// Set Prefix
}
