<?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"));
本文实例讲述了PHP 扩展Memcached命令用法。分享给大家供大家参考,具体如下:
windows 下没有memcached的扩展,只有memcache的扩展。亲测,两者之间还是有很大差别的。所以建议还是在linux做。<?php
$mem = new Memcached();
//添加一台服务器资源
$mem->addServer('127.0.0.1', '11211');
//添加多台,分布式存储,第三个参数为权重值
/*
$servers = array(
array('127.0.0.1', 11211, 33),
array('127.0.0.2', 11211, 67),
);
$res = $mem->addServers($servers);
*/
//设置:键 值 过期时间(秒)
$mem->set('name', 'huangyuxin', 5);
//注意:最大生命周期可设置为60*60*24*30 三十天的时间
//再往后的话要加上时间戳 time()+60*60*24*31(三十一天)
//获取值
$value = $mem->get('name');
//添加值,如果存在此键,false
$result = $mem->add('name','zhangsan');
//追加: 键 值 ,追加在一个已经存在的值得后面,不存在也为false
//setOption 这一句必须加上,不然追加不上
//prepend 前面追加
//如果Memcached::OPT_COMPRESSION常量开启,这个操作会失败,并引发一个警告,因为向压缩数据 后追加数据可能会导致解压不了。
$mem->setOption(Memcached::OPT_COMPRESSION, false);
$mem->append('name','haha');
$value = $mem->get('name');
//这个是减掉元素的值,两个参数,第二个参数决定减掉数值几,默认是 1 ,increment 是加
$mem->set('age', 12, 30);
$mem->decrement('age');
$mem->decrement('age',2);
$value = $mem->get('age');
//删除元素
$mem->delete('age');
$mem->delete('age',60);
/*
注意:
服务端在这段时间拒绝对这个key的add和replace命令.
由于这个时间段的存在, 元素被放入一个删除队列
表明它不可以通过get命令获取到值
但是同时 add和replace命令也从服务端内存删除
(表明元素会被立即删除并且之后对这个 key的存储命令也会成功)
*/
//删除多个
$mem->add('age', 12, 60);
$mem->add('name', 'huangyuxin', 60);
$res = $mem->deleteMulti(array('age','name'));
//作废 :flush不会 真正的释放已有元素的内存, 而是逐渐的存入新元素重用那些内存。
$mem->flush(10);//10秒内清除元素
//获取所有键
$mem->getAllKeys();
/*
Memcached::getDelayed()向Memcached服务端发出一个检索
keys指定的多个 key对应元素的请求。这个方法不会等待响应而
是立即返回。当你需要收集元素值时, 调Memcached::fetch()
或 Memcached::fetchAll()。如果with_cas设置为true,会
同时请求每个元素的CAS标记。
*/
$m->set('int', 99);
$m->set('array', array(11, 12));
$m->getDelayed(array('int', 'array'), true);
var_dump($m->fetchAll());
//获取多个值的信息
$mem->set('age', 12, 60);
$mem->set('name', 'huangyuxin', 60);
$res = $mem->getMulti(array('age', 'name'));
//设置多个键
$items = array(
'key1' => 'value1',
'key2' => 'value2',
'key3' => 'value3',
);
$mem->setMulti($items);
$res = $mem->get('key1');//value
//返回系统常量
var_dump($mem->getOption(Memcached::OPT_COMPRESSION));
//返回最后一次操作的结果描述消息
$mem->add('a', 'bar'); // first time should succeed
echo $mem->getResultMessage(), "\n"; //SUCCESS
//查看此key在哪个服务器上
$mem->add('a', 'bar'); // first time should succeed
$res = $mem->getServerByKey('a');
//array(3) { ["host"]=> string(9) "127.0.0.1" ["port"]=> int(11211) ["weight"]=> int(0) }
//返回服务器列表
var_dump($mem->getServerList());
//返回服务器状态
var_dump($mem->getServerList());
//服务器版本
print_r($mem->getVersion());
//判断是否是持久链接
$res = $mem->isPersistent();
//Memcached::replace()和Memcached::set()类似,但是如果 服务端不存在key, 操作将失败。
$m->set('hh', 'aaaa');
$m->replace('hh', 'bbbb');
$res = $m->get('hh');
//删除从已知的服务器列表中的所有缓存服务器,重置回空。
$mem->resetServerList();
//对某一key重新设置生命周期
$m->set('aaaa', 'aaaa', 600);
$m->touch('aaaa', 5);
$value= $m->get('aaaa');
//关闭打开的链接
$m->quit();
var_dump($value);
以下后缀为ByKey一般为多台Memcached Server使用,掌握以上的命令,下面基本都会用了。touch->touchByKey
setMulti->setMultiByKey
getMulti->getMultiBykey
replace->replaceByKey
append->appendByKey
prepend->prependByKey
getServerByKey
getdelay->getDelayedByKey
increment->incrementByKey
decrement->decrementByKey
add->addByKey
get->getByKey
delete->deleteMultiByKey$m->addByKey('指定服务器','键',"值")
PHP-Memcached手册
PHP: Memcached - Manual https://www.php.net/manual/zh/class.memcached.php