PHP 8.3.4 Released!

Memcached::addByKey

(PECL memcached >= 0.1.0)

Memcached::addByKey在特定服务器上向新 key 添加元素

说明

public Memcached::addByKey(
    string $server_key,
    string $key,
    mixed $value,
    int $expiration = 0
): 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

参见

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top