Memcached::add

(PECL memcached >= 0.1.0)

Memcached::add — 向新 key 添加元素

说明

public Memcached::add(string $key, mixed $value, int $expiration = 0): bool

Memcached::add() 与 Memcached::set() 类似，但如果 key 已经在服务端存在，则操作失败。

参数

key: 用于存储值的键名。
value: 存储的值。
expiration: 到期时间，默认为 0。更多信息请参见到期时间。

返回值

成功时返回 true，或者在失败时返回 false。如果 key 已经存在，Memcached::getResultCode() 将会返回 Memcached::RES_NOTSTORED。

参见

Memcached::addByKey() - 在特定服务器上向新 key 添加元素
Memcached::set() - 存储一个元素
Memcached::replace() - 替换已存在 key 下的元素

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 1 note

down

ilya dot chase at yandex dot ru ¶

5 years ago

Note that this operation is atomic, means that it's safe from race condition operation (since memcached is running in single process). You can use this method for locks and can be sure that two requests will not get "true" simultaneously using this method.