Memcached::getByKey
(PECL memcached >= 0.1.0)
Memcached::getByKey — 从特定的服务器检索元素
说明
public Memcached::getByKey
( string
$server_key
, string $key
[, callback $cache_cb
[, float &$cas_token
]] ) : mixed
Memcached::getByKey()除了可以通过server_key
参数自由的指定key
所映射的服务器外, 在功能上等同于Memcached::get()。(译注: 关于*ByKey系列方法及$server_key的工作原理请参照addByKey方法文档)
参数
-
server_key
-
本键名用于识别储存和读取值的服务器。没有将实际的键名散列到具体的项目,而是在决定与哪一个 memcached 服务器通信时将其散列为服务器键名。这使得关联的项目在单一的服务上被组合起来以提高多重操作的效率。
-
key
-
要抓取的元素的key。
-
cache_cb
-
通读缓存回掉函数或
NULL
. -
cas_token
-
检索的元素的CAS标记值。
返回值
返回存储在服务端的元素的值或者在其他情况下返回FALSE
。
如果key不存在,Memcached::getResultCode()返回Memcached::RES_NOTFOUND
。