腾讯CMEM的PHP扩展

CMEM是什么？

CMEM全称为Cloud Memory，是腾讯提供的高性能内存级持久化存储服务，适用于数据量小、访问量高、key-value存储的场景。

CMEM基于一个存储键/值对的hashmap，数据使用内存存储，并保证数据的持久性。

CMEM PHP Extension是什么？

CMEM基于标准的Memcached协议以及接口，只是将数据获取接口增加返回值设定。

Memcached的Get协议没有设计返回码，所以Memcached API返回NO_DATA时，有可能是网络原因造成的，不能完全信任。 使用如下流程将是非常危险的，将造成用户数据初始化：

if(NO_DATA) {
    InitData();
}

为解决上述问题，CMEM提供了Memcahced文本扩展协议，增加两个扩展的命令get_ext， gets_ext，使客户端可以根据返回码判断数据是否存在。 这样可以避免网络和设备故障时get不到数据而导致用户数据被误初始化。

CMEM如何使用？

在get具体的数据使用，传入两个引用变量$flag、$code：

• flag是Memcache原有扩展自带的，在发送set命令时设置的标志项，使用和用法和以前一致；
• code是CMEM扩展新增的，当且仅当$code返回值为0时，get到的数据是可信的，其他情况，均不可信；

具体使用，请参见如下代码：

//初始化CMEM类
$mem = new CMEM;

//连接CMEM服务
$mem->connect("127.0.0.1", 11211);

//保存key为cmem的数据
$mem->set('cmem', 'CMEM work nice', 0, 86400);

//初始化$flag、$code，为引用传入准备
$flag = $code = -1;

//get方法，同时支持传入key组成的数组，同样返回的$code也是数组
$returnValue = $mem->get('cmem', &$flag, &$code);

//当且仅当$code返回值为0时，get到的数据是可信的，其他情况，均不可信
if($code == 0) {
        echo "the value is safe, value is: <b>{$returnValue}</b>";
} else {
        echo "the value is not safe, don't use it";
}

类的使用以及方法对比

CMEM类的用法与Memcache类的用法唯一区别就是将new Memcache变成new CMEM，其他均一致。（推荐此种方式）

//连接
$mem = new Memcache;
$mem->connect("127.0.0.1", 11211);

//保存数据
$mem->set('key1', 'This is first value', 0, 60);
$val = $mem->get('key1');
echo "Get key1 value: " . $val ."<br />";

//替换数据
$mem->replace('key1', 'This is replace value', 0, 60);
$val = $mem->get('key1');
echo "Get key1 value: " . $val . "<br />";

//保存数组
$arr = array('aaa', 'bbb', 'ccc', 'ddd');
$mem->set('key2', $arr, 0, 60);
$val2 = $mem->get('key2');
echo "Get key2 value: ";
print_r($val2);
echo "<br />";

//删除数据
$mem->delete('key1');
$val = $mem->get('key1');
echo "Get key1 value: " . $val . "<br />";

//清除所有数据
$mem->flush();
$val2 = $mem->get('key2');
echo "Get key2 value: ";
print_r($val2);
echo "<br />";

//关闭连接
$mem->close();

上例中唯一需要改变的就是第一行。

$mem = new CMEM;
$mem->connect("127.0.0.1", 11211);

如果对Memcache的使用有疑问，可以参考《 Memcache基础教程》。

----------------------------------------------------华丽丽的分割线----------------------------------------------------------

相关链接

http://www.ccvita.com/450.html

http://code.google.com/p/cmem/

http://wiki.opensns.qq.com/wiki/CMEM