©
本文档使用 PHP中文网手册 发布
(PECL memcached >= 0.1.0)
Memcached::cas — 比较并交换值
$cas_token
, string $key
, mixed $value
[, int $expiration
] ) Memcached::cas() 执行一个“检查并设置”的操作,因此,它仅在当前客户端最后一次取值后,该key
对应的值没有被其他客户端修改的情况下, 才能够将值写入。检查是通过cas_token
参数进行的,
这个参数是Memcach指定给已经存在的元素的一个唯一的64位值, 怎样获取这个值请查看 Memcached::get*()
系列方法的文档。注意:这个值作为double类型是因为PHP的整型空间限制。
译注:这是Memcached扩展比Memcache扩展一个非常重要的优势, 在这样一个系统级(Memcache自身提供)的冲突检测机制(乐观锁)下, 我们才能保证高并发下的数据安全。
cas_token
与已存在元素关联的唯一的值,由Memcache生成。
key
用于存储值的键名。
value
存储的值。
expiration
到期时间,默认为 0。 更多信息请参见到期时间。
成功时返回 TRUE
, 或者在失败时返回 FALSE
。
如果在元素尝试存储时发现在本客户端最后一次获取后被其他客户端修改, Memcached::getResultCode()
将返回 Memcached::RES_DATA_EXISTS
。
Example #1 Memcached::cas() 示例
<?php
$m = new Memcached ();
$m -> addServer ( 'localhost' , 11211 );
do {
$ips = $m -> get ( 'ip_block' , null , $cas );
if ( $m -> getResultCode () == Memcached :: RES_NOTFOUND ) {
$ips = array( $_SERVER [ 'REMOTE_ADDR' ]);
$m -> add ( 'ip_block' , $ips );
} else {
$ips [] = $_SERVER [ 'REMOTE_ADDR' ];
$m -> cas ( $cas , 'ip_block' , $ips );
}
} while ( $m -> getResultCode () != Memcached :: RES_SUCCESS );
?>
[#1] abodera at gmail dot com [2010-04-27 13:19:39]
Watch out!
When using binary protocol, the expected result after cas() is 21 (Memcached::RES_END).
For example, to make the above example #1 work with binary protocol, use the following:
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->setOption(Memcached::OPT_BINARY_PROTOCOL,true)
// [...]
} else {
$ips[] = $_SERVER['REMOTE_ADDR'];
$m->cas($cas, 'ip_block', $ips);
}
} while ($m->getResultCode() != Memcached::RES_END);
?>