array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'memcache.add.php', 1 => 'Memcache::add', 2 => 'Add an item to the server', ), 'up' => array ( 0 => 'class.memcache.php', 1 => 'Memcache', ), 'prev' => array ( 0 => 'class.memcache.php', 1 => 'Memcache', ), 'next' => array ( 0 => 'memcache.addserver.php', 1 => 'Memcache::addServer', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/memcache/memcache/add.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Memcache::add

memcache_add

(PECL memcache >= 0.2.0)

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

说明

Memcache::add(
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool
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);

?>

参见