Edit Report a Bug

Memcached::add

(PECL memcached >= 0.1.0)

Memcached::add — 向新 key 添加元素

说明

public Memcached::add(string $key, mixed $value, int $expiration = 0): bool

Memcached::add() 与 Memcached::set() 类似，但如果 key 已经在服务端存在，则操作失败。

参数

key: 用于存储值的键名。
value: 存储的值。
expiration: 到期时间，默认为 0。更多信息请参见到期时间。

返回值

成功时返回 true，或者在失败时返回 false。如果 key 已经存在，Memcached::getResultCode() 将会返回 Memcached::RES_NOTSTORED。

参见

Memcached::addByKey() - 在特定服务器上向新 key 添加元素
Memcached::set() - 存储一个元素
Memcached::replace() - 替换已存在 key 下的元素

add a note

User Contributed Notes 2 notes

down

ilya dot chase at yandex dot ru ¶

5 years ago


Note that this operation is atomic, means that it's safe from race condition operation (since memcached is running in single process). You can use this method for locks and can be sure that two requests will not get "true" simultaneously using this method.

down

-28

zhoujunwen888 at 126 dot com ¶

9 years ago


<?php
/**
 * Created by PhpStorm.
 * User: zhoujunwen
 * Date: 15/6/17
 * Time: 下午4:51
 */
    $mem  = new Memcached();

    $mem->addServer('127.0.0.1',11211);
    if( $mem->add("mystr","this is a memcache test!",3600)){
        echo  '原始数据缓存成功!';
    }else{
        echo '数据已存在：'.$mem->get("mystr");
    }

?>

add a note