PHP操作Memcached

<?php

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

//向服务器池中增加一个服务器
/*string $host , int $port [, int $weight  = 0 ]*/
/*weight : 此服务器相对于服务器池中所有服务器的权重。此参数用来控制服务器在操作时被选中的概率。这个仅用于一致性分布选项，并且这个值通常是由服务端分配的内存来设置的*/
$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->set('name', 'yhq', 3600);
//$memcache->set('name', 123, 3600);
//$memcache->set('name', 12.3, 3600);
//$memcache->set('name', true, 3600);//true=1 false=0
//$memcache->set('name', json_encode([1=>'yhq',2=>'qhh']), 3600); //json_encode serialize
//$memcache->set('name', NULL, 3600);
/*class dog
{
    public $name;
    public $age;

    public function __construct($name, $age)
    {
        $this->name = $name;
        $this->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 = [
    'key1' => 'value1',
    'key2' => 'value2',
    'key3' => 'value3'
];
$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->set('name', 'yhq');
//$memcache->append('name', 'qhh');

/*Memcached::increment — 增加数值元素的值 默认+1
Memcached::increment() 将一个数值元素增加参数offset指定的大小。如果元素的值不是数值类型，将其作为0处理。如果元素不存在 Memcached::increment() 失败。*/
//$memcache->set('num',1);
//$memcache->increment('num',1);

/*Memcached::decrement — 减小数值元素的值
Memcached::decrement() 减小一个数值元素的值，减小多少由参数offset决定。如果元素的值不是数值，以0值对待。如果减小后的值小于0,则新的值被设置为0.如果元素不存在， Memcached::decrement()  失败。 */
//$memcache->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->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->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->setOption(Memcached :: OPT_COMPRESSION, true);
//$memcache->setOptions(array(Memcached :: OPT_HASH => Memcached :: HASH_MURMUR, Memcached :: OPT_PREFIX_KEY => "widgets"));