<?php

$memcache = new Memcached(); //创建一个memcache对象


//向服务器池中增加一个服务器

/*string $host , int $port [, int \(weight  = 0 ]</span><span style="color: #008000;">*/</span>
<span style="color: #008000;">/*</span><span style="color: #008000;">weight : 此服务器相对于服务器池中所有服务器的权重。此参数用来控制服务器在操作时被选中的概率。这个仅用于一致性分布选项，并且这个值通常是由服务端分配的内存来设置的</span><span style="color: #008000;">*/</span>
<span style="color: #800080;">\)memcache->addServer('10.16.134.65', 11211, 33);


/\(addServers = [
['10.16.134.65', 11211],
['10.16.134.75', 11211],
];
//向服务器池中增加多台服务器
//当使用这个方法的时候,网络连接并不会立刻建立，而是直到真正使用的时候才建立。 因此在加入大量服务器到连接池中时也是没有开销的，因为它们可能并不会被使用。
\)memcache->addServers($addServers);/


/到期时间 : 一些存储命令在发送时会包含一个失效值（与一个元素或一个客户端操作请求相关）到服务端。所有这类用法，实际发送的值可以 是一个Unix时间戳（自1970年1月1日起至失效时间的整型秒数），或者是一个从现在算起的以秒为单位的数字。对于后一种情况，这个 秒数不能超过60×60×24×30（30天时间的秒数）;如果失效的值大于这个值， 服务端会将其作为一个真实的Unix时间戳来处理而不是 自当前时间的偏移。

如果失效值被设置为0（默认），此元素永不过期（但是它可能由于服务端为了给其他新的元素分配空间而被删除）。 /


//谨记：资源类型变量（比如文件或连接）不能被存储在缓存中，因为它们在序列化状态不能被完整描述。


//字符串0 整型1 浮点2 布尔3 NULL对象5


/Memcached::set — 存储一个元素

值可以是任何有效的非资源型php类型， 因为资源类型不能被序列化存储。如果 Memcached::OPT_COMPRESSION选项开启，序列化的值同样会被压缩存储。/

//\(memcache-&gt;set('name', 'yhq', 3600);
//\)memcache->set('name', 123, 3600);

//\(memcache-&gt;set('name', 12.3, 3600);
//\)memcache->set('name', true, 3600);//true=1 false=0

//\(memcache-&gt;set('name', json_encode([1=&gt;'yhq',2=&gt;'qhh']), 3600); //json_encode serialize
//\)memcache->set('name', NULL, 3600);

/*class dog

{

public $name;

public $age;


public function __construct($name, $age)
{
    $this-&gt;name = $name;
    $this-&gt;age = $age;
}



}

\(dog = new dog('狗',5);
//在其他文件get对象会 __PHP_Incomplete_Class_Name,需要在其他文件声明这个类
\)memcache->set('name', $dog, 3600);*/


/Memcached::setMulti — 存储多个元素

Memcached::setMulti() 类似于 Memcached::set() ， 但是使用了参数items指定多个元素来替代单独的key/value设置以便于对多个元素的操作。expiration 参数指定的时候一次应用到所有的元素上。 /

\(items</span> =<span style="color: #000000;"> [
    </span>'key1' =&gt; 'value1',
    'key2' =&gt; 'value2',
    'key3' =&gt; 'value3'<span style="color: #000000;">
];
</span><span style="color: #800080;">\)memcache->setMulti($items, 666);


/Memcached::add — 向一个新的key下面增加一个元素

Memcached::add() 与 Memcached::set() 类似，但是如果 key已经在服务端存在，此操作会失败。/

//$memcache->add('name','yhq',666);


/Memcached::append — 向已存在元素后追加数据  Memcached::prepend — 向一个已存在的元素前面追加数据

如果 Memcached::OPT_COMPRESSION 常量开启，这个操作会失败，并引发一个警告，因为向压缩数据后追加数据可能会导致解压不了。/

//\(memcache-&gt;set('name', 'yhq');
//\)memcache->append('name', 'qhh');


/Memcached::increment — 增加数值元素的值 默认+1

Memcached::increment() 将一个数值元素增加参数offset指定的大小。如果元素的值不是数值类型，将其作为0处理。如果元素不存在 Memcached::increment() 失败。/

//\(memcache-&gt;set('num',1);
//\)memcache->increment('num',1);


/Memcached::decrement — 减小数值元素的值

Memcached::decrement() 减小一个数值元素的值，减小多少由参数offset决定。如果元素的值不是数值，以0值对待。如果减小后的值小于0,则新的值被设置为0.如果元素不存在， Memcached::decrement()  失败。 /

//\(memcache-&gt;set('num',1);
//\)memcache->decrement('num',1);


/Memcached::delete — 删除一个元素  Memcached::deleteMulti - 删除多个元素

Memcached::delete() 从服务端删除key对应的元素. 参数time是一个秒为单位的时间(或一个UNIX时间戳表明直到那个时间), 用来表明客户端希望服务端在这段时间拒绝对这个key的add和replace命令. 由于这个时间段的存在, 元素被放入一个删除队列, 表明它不可以通过get命令获取到值, 但是同时 add和replace命令也会失败(无论如何set命令都会成功). 在这段时间过去后, 元素最终被从服务端内存删除.time参数默认0(表明元素会被立即删除并且之后对这个 key的存储命令也会成功)/


//\(memcache-&gt;delete('num');
//\)memcache->deleteMulti(['key1','key2','key3']);


/Memcached::flush — 作废缓存中的所有元素

Memcached::flush() 立即（默认）或者在delay延迟后作废所有缓存中已经存在的元素。在作废之后检索命令将不会有任何返回（除非在执行 Memcached::flush() 作废之后，该key下被重新存储过）。flush不会真正的释放已有元素的内存， 而是逐渐的存入新元素重用那些内存。 /

//$memcache->flush(10); //10秒内清除所有元素


/Memcached::get — 检索一个元素 Memcached::getMulti — 检索多个元素 /

//$num = \(memcache-&gt;get('num');
//\)num = $memcache->getMulti(['key1','key2','key3']);


/Memcached::getAllKeys — 获取服务器所有key/

//$Keys = $memcache->getAllKeys();


/Memcached::getOption — 获取Memcached的选项值

这个方法返回option指定的Memcached选项的值。一些选项是和libmemcached中相对应的，也有一些特殊的选项仅仅是扩展自身的。关于选项的更多信息请查看 https://www.cnblogs.com/yhq-qhh/p/10247274.html。/

//$OPT = $memcache->getOption(Memcached::OPT_COMPRESSION );


/Memcached::getResultMessage — 返回最后一次操作的结果描述消息/

//$Message = $memcache->getResultMessage();


/Memcached::getServerList — 获取服务器池中的服务器列表 /

//$ServerList = $memcache->getServerList();


/Memcached::getStats — 获取服务器池的统计信息  https://www.cnblogs.com/yhq-qhh/p/9918253.html /

//$status = $memcache->getStats();


/Memcached::getVersion — 获取服务器池中所有服务器的版本信息 /

//$version = $memcache->getVersion();


/Memcached::quit — 关闭所有打开的链接。 /

//$memcache->quit();


/Memcached::replace — 替换已存在key下的元素

Memcached::replace() 和 Memcached::set() 类似，但是如果服务端不存在key， 操作将失败。

/

//$replace = $memcache->replace('name','yhq');


/Memcached::setOption — 设置一个memcached选项  Memcached::setOptions — Set Memcached options

这个方法用来设置Memcached option的值。一些选项和libmemcached中定义的类似， 还有一些则是扩展所特有的。

关于选项的更多信息请参阅 https://www.cnblogs.com/yhq-qhh/p/10247274.html

/

//\(memcache-&gt;setOption(Memcached :: OPT_COMPRESSION, true);
//\)memcache->setOptions(array(Memcached :: OPT_HASH => Memcached :: HASH_MURMUR, Memcached :: OPT_PREFIX_KEY => "widgets"));