大网数据广告活动
PHP 语言与运行手册

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

· 52CE 我爱测

Memcached::addByKey() 在功能上等同于 Memcached::add(),只是可以自由的指定 server_key 用于将 key 映射到特定的服务器。如果需要将一堆相关的 key 保存在特定的服务器时非常有用。(译注: $server_key 也是普通的 key, ByKey 系列接口的工作过程是: 首先, 对 $server_key 进行 hash, 得到 $server_key 应该存储的服务器, 然后将相应的操作在 $server_key 所在的服务器上进行。)

Memcached::addByKey

(PECL memcached >= 0.1.0)

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

说明

public function 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。

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。