Memcache/Memcached的PHP操作手册（纯手稿版）

Memcache和Memcached 其实是一个东西，只是php中要是用的扩展不一样, 2009年左右有人丰富memcache的用法和性能，编写了一个libmemcached是独立第三方client library，才有了memcached ,用法也有了很大的改进比如添加了 getMulti() 批量获取键值

windows下只能安装php_memcache.dll 扩展并不存在 php_memcached.dll, 所以windows 中只能使用$mcd = new Memcache() 不能使用new Memcached()

---

Memcache 类

$memcache = new Memcache;

$memcache->connect('127.0.0.1', 11211);

$memcache->pconnec('127.0.0.1', 11211);
// 打开一个到服务器的持久化连接 , 连接不会在脚本执行结束后或者close()被调用后关闭

$memcache->addServer('123.57.210.55', 11211,$persistent,$weight);
// 向连接池中添加一个memcache服务器 $persistent 是否持久化连接 $weight
   控制桶的数量提升被选中的权重 $timeout 表示连续持续时间

$memcache->set('name', 'TK');
// 默认存储不压缩 不过期 , 其中字符串和数值直接存储，其他类型序列化后存储
   set其实是add方法和replace方法集合

$memcache->set('email', 'julylovin@163.com',MEMCACHE_COMPRESSED,5);
// MEMCACHE_COMPRESSED设置存储是否压缩 , 5表示5秒后过期但是最大只能设置2592000秒(30天)
   如果设置为0 表示永不过期, 可以设置将来的时间戳

$memcache->set('info',array('age'=>'26','salary'=>'1000'));
// 可以直接存储数组,redis中存储需要手动serialize()序列化

$memcache->add('counter', '10', MEMCACHE_COMPRESSED, 0);
//如果键值存在会返回false , 如果不存在, 和set方法一样，生成一个counter的key并赋值10

$memcache->replace ('counter', '10');
 //如果键值不存在会返回false , 如果存在, 替换counter的值为10

$memcache->increment('counter', 3);
// 首先将元素当前值转换成数值然后减去value 操作counter键值+3
   若键不存在 则返回false 不能用于压缩的键值操作，否则get键会失败

$memcache->decrement('counter', 3); // 操作counter键值-3 , 若键不存在 则返回false

$memcache->delete('counter', 3); // 操作删除键counter ， 3表示3秒内删除，默认是0即立即删除

$memcache->flush(); //flush()立即使所有已经存在的元素失效

$memcache->getExtendedStats ();
// 返回一个二维关联数据的服务器统计信息。数组的key由host:port方式组成

$memcache->getServerStatus ('127.0.0.1'); // 获取返回一个服务器的在线/离线状态  0表示离线 非0在线

$memcache->getStats(); // 获取服务器统计信息

$memcache->getVersion(); // 返回服务器版本信息

$memcache->setCompressThreshold ($threshold, $min_saving);
//  开启大值自动压缩   $threshold设置压缩阀值 2000字节 ，即字节数大于2K 就压缩
    $min_saving  0--1之间  0.2表示压缩20%

$memcache->setServerParams('memcache_host', 11211, 1, 15, true, '_callback_memcache_failure');
// $memcache->addServer('memcache_host', 11211, false, 1, 1, -1, false);
   已经通过addServer 配置过服务器 使用setServerParams 重新设置配置信息

---

Memcached 类

此次练习我是在linux上安装了phpstorm，linux平台开发配置看我的其他文章

$memcached = new Memcached(); //   必须安装memcached扩展 不会安装看我的相关文章

#server_key名词解释#
#当台服务IP和端口完全连通好之后，构成一个hash环，$server_key才会生效
#$server_key 只是为了存储的key打个标记 比如有三台 memcache服务器 (A B C ) , 指定 server_key
'master-a' 'master-b' 'master-c' 分别存储 会员 订单 日志 等等

$memcached->addServer('192.168.206.128',11211); // 连接服务器

$memcached->setOption(Memcached::OPT_COMPRESSION, false);
//配置存储不压缩，压缩value不利于递增递减

$memcached->setOption(Memcached::OPT_LIBKETAMA_COMPATIBLE, true);
//

$memcached->addServers(array( //添加多台服务器分布式
    array('192.168.206.128', 11311, 20),
    array('192.168.206.128', 11411, 30)
));

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

$memcached->set('name','TK');

$memcached->setByKey('server_master_db','mage','28');
# 指定 server_key server_master_db 存储键mage

$memcached->setMulti(array('salary'=>'3000','email'=>'julylovin@163.com'));
// 存储多个元素

$memcached->setMultiByKey('server_master_db',
                    array('salary'=>'3000','email'=>'julylovin@163.com'));
//  'server_master_db'服务器 存储多个元素

$memcached->add('name','TK'); // 键name不存在添加value 否则添加失败

$memcached->addByKey('server_master_db','mname','MTK');

$memcached->append('key','-816'); // 键key的value后追加字符串 -816

$memcached->appendByKey('server_master_db','mname','-923');

$memcached->prepend('name','pre-') ; #向一个已存在的元素前面追加数据

$memcached->prependByKey('server_master_db','name','pre-') ;
# 使用server_key自由的将key映射到指定服务器 向一个已存在的元素前面追加数据

$memcached->get('name');

$memcached->get('name',null,$cas);
# 第2参数指定缓存回掉函数 ，不指定传null
# 如果元素被找到，并且返回变量 $cas 内部是通过引用变量回传的

$memcached->getByKey('server_master_db','mname');  # 从特定的服务器检索元素

$memcached->getAllKeys(); // bug 我一致返回是false

$memcached->cas($cas, 'name', 'TangKang');
#要与$memcached->get('name',null,$cas) 方法搭配用 才可以拿到 $cas变量
#它仅在当前客户端最后一次取值后，该key 对应的值没有被其他客户端修改的情况下， 才能够将值写入
#这是Memcached扩展比Memcache扩展一个非常重要的优势
 在这样一个系统级（Memcache自身提供）的冲突检测机制（乐观锁）下， 我们才能保证高并发下的数据安全

$memcached->casByKey($cas,'server_master_db', 'name', 'TangKang');

$memcached->increment('age','1');
#增加数值元素的值  如果元素的值不是数值类型，将其作为0处理

$memcached->incrementByKey('server_master_db','age','1');
# 用于识别储存和读取值的服务器

$memcached->decrement('age','1');
#减少数值元素的值  如果元素的值不是数值类型，将其作为0处理

$memcached->decrementByKey('server_master_db','age','1');
# 用于识别储存和读取值的服务器

$memcached->getDelayed(array('name', 'age'), true, null);
# 请求多个元素， 如果with_cas设置为true，会同时请求每个元素的CAS标记
  指定一个result callback来替代明确的抓取结果

$memcached->getDelayedByKey('server_master_db',array('name', 'age'), true, null);

$memcached->fetch();
# 搭配 $memcached->getDelayed()使用, 从最后一次请求中抓取下一个结果

$memcached->fetchAll();
#抓取最后一次请求的结果集中剩余的所有结果

$memcached->getMulti(array('name', 'age')); #检索多个元素

$memcached->getMultiByKey('server_master_db',array('mname', 'mage'));
# 从特定服务器检索多个元素
# 与 $this->memcached->fetchAll() 搭配使用

$memcached->getOption(Memcached::OPT_COMPRESSION);
# 获取Memcached的选项值

$memcached->getResultCode() ;
# 返回最后一次操作的结果代码   Memcached::RES_NOTSTORED

$memcached->getResultMessage() ;
# 返回最后一次操作的结果描述消息

$memcached->getServerByKey('server_master_db') ; # 获取一个key所映射的服务器信息

$memcached->getServerList() ; #  获取服务器池中的服务器列表

$memcached->getStats() ; #  获取服务器池的统计信息

$memcached->getVersion() ;  #  获取服务器池中所有服务器的版本信息

$memcached->isPersistent() ; #判断当前连接是否是长连接

$memcached->replace('name','pre-julylovin') ;
#set()类似，但是如果 服务端不存在key， 操作将失败

$memcached->replaceByKey('server_master_db','name','pre-julylovin') ;
#setBykey()类似，但是如果 服务端不存在key， 操作将失败

$memcached->resetServerList() ; //清楚服务器池信息

$memcached->setOption(Memcached::OPT_PREFIX_KEY, "widgets") ;
#设置一个memcached选项

$memcached->setOptions(array()) ;
#设置一个memcached选项

$memcached->setSaslAuthData($username , $password ) ;
#setSaslAuthData 方法不存在

$memcached->touch('name', 10) ;
#设置键name 10秒后过期(只适用30天之内的秒数) ，30天以后请设置时间戳

$memcached->touchByKey('server_master_db','name',10) ;

$memcached->delete('age',10);
#10秒(秒数/时间戳)内删除一个元素  这个键已经存在删除队列
 该键对应的get、add、replace命令都不可用，直到删除

$memcached->deleteByKey('server_master_db','age');

$memcached->deleteMulti(array('age','name')); #传入array删除多个key 

$memcached->deleteMultiByKey('server_master_db',array('age','name'));

$memcached->quit(); # 关闭所有打开的链接