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

Memcache::add · 增加条目到服务器

· 52CE 我爱测

仅当服务器不存在该 key 时,Memcache::add() 以 key 作为 key 存储变量 var。

Memcache::add

memcache_add

(PECL memcache >= 0.2.0)

Memcache::add -- memcache_add — 增加条目到服务器

说明

function Memcache::add(
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool
function memcache_add(
    Memcache $memcache,
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool

仅当服务器不存在该 key 时,Memcache::add() 以 key 作为 key 存储变量 var。

参数

key

将要分配给变量的key。

var

将要被存储的变量。字符串和整型被以原文存储,其他类型序列化后存储。

flag

使用MEMCACHE_COMPRESSED标记对数据进行压缩(使用zlib)。

expire

当前写入缓存的数据的失效时间。如果此值设置为0表明此数据永不过期。你可以设置一个UNIX时间戳或 以秒为单位的整数(从当前算起的时间差)来说明此数据的过期时间,但是在后一种设置方式中,不能超过 2592000秒(30天)。

返回值

成功时返回 true, 或者在失败时返回 false。 如果这个key已经存在返回false。 Memcache::add()方法的其他行为类似 Memcache::set()。

示例

示例 #1 Memcache::add()示例

<?php

$memcache_obj = memcache_connect("localhost", 11211);

/* 面向过程编程 API */
memcache_add($memcache_obj, 'var_key', 'test variable', false, 30);

/* 面向对象编程 API */
$memcache_obj->add('var_key', 'test variable', false, 30);

?>

参见

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

资料来源与适用范围

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

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

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