Memcached::addByKey
(PECL memcached >= 0.1.0)
Memcached::addByKey — 在指定服务器上的一个新的key下增加一个元素
说明
public
Memcached::addByKey (
string
$server_key
,
string $key
,
mixed $value
[,
int $expiration
] ) :
bool
Memcached::addByKey()在功能上等同于Memcached::add(), 不过这种方式可以自由的指定server_key
用于将key
映射到特定的服务器。这在你需要将一些相关联的key保存在一个特定的服务器时非常有用。(译注: $server_key也是一个普通的key, *ByKey系列接口的工作过程是: 首先, 对$server_key进行hash, 得到$server_key应该存储的服务器, 然后将相应的操作在 $server_key所在的服务器上进行.)
参数
-
server_key
-
本键名用于识别储存和读取值的服务器。没有将实际的键名散列到具体的项目,而是在决定与哪一个 memcached 服务器通信时将其散列为服务器键名。这使得关联的项目在单一的服务上被组合起来以提高多重操作的效率。
-
key
-
用于存储值的键名。
-
value
-
存储的值。
-
expiration
-
到期时间,默认为 0。 更多信息请参见到期时间。
返回值
成功时返回 TRUE
, 或者在失败时返回 FALSE
。 如果key已经存在,Memcached::getResultCode()方法将会返回Memcached::RES_NOTSTORED
。
参见
- Memcached::add() - 向一个新的key下面增加一个元素
- Memcached::set() - 存储一个元素
- Memcached::replace() - 替换已存在key下的元素