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

Yac::set · 向缓存中存储一个值

· 52CE 我爱测

string 类型的键,或者一个由 key => value 键值对组成的 array,一次调用存储多个条目。

Yac::set

(PECL yac >= 1.0.0)

Yac::set — 向缓存中存储一个值

说明

public function Yac::set(string|array $key, mixed $value, int $ttl = 0): bool
public function Yac::set(array $values, int $ttl = 0): bool

向缓存中存储一个值。如果键已存在,则覆盖已有条目,无论其是否已过期。

参数

key

string 类型的键,或者一个由 key => value 键值对组成的 array,一次调用存储多个条目。

value

要存储的值。除 resource 外的所有 PHP 类型都可以存储。仅在单键形式下使用;当 key 是数组时,该参数位置实际上是可选的 ttl。

ttl

生存时间,单位为秒。0 表示条目永不因时间过期。

返回值

成功时返回 true,失败时返回 false。

示例

示例 #1 Yac::set() 示例

<?php
$yac = new Yac();

$yac->set("foo", "bar");                    // 存储单个值
$yac->set("foo", "baz");                    // 覆盖已有条目
?>

示例 #2 存储带 TTL 的条目

<?php
$yac = new Yac();

// ttl 以秒为单位:该条目 5 秒后过期
$yac->set("short-lived", "value", 5);
sleep(6);
var_dump($yac->get("short-lived"));        // bool(false):已过期
?>

示例 #3 一次存储多个条目

<?php
$yac = new Yac();

// 一次调用存储多个键值对
$yac->set(array("a" => 1, "b" => 2));
?>

参见

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

资料来源与适用范围

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

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

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