Php/docs/memcache.add

• PHP Manual
• Memcache
• 增加一个条目到缓存服务器

Memcache::add

(PECL memcache >= 0.2.0)

Memcache::add — 增加一个条目到缓存服务器

说明

Memcache::add ( string $key , mixed $var [, int $flag [, int $expire ]] ) : bool

Memcache::add()方法在缓存服务器之前不存在key时， 以key作为key存储一个变量var到缓存服务器。 同样可以使用函数memcache_add()。

参数

key

将要分配给变量的key。

var

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

flag

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

expire

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

返回值

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

范例

Example #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);?>

参见

• Memcache::set() - Store data at the server
• Memcache::replace() - 替换已经存在的元素的值