Submit a Pull Request Report a Bug

Memcached::add

(PECL memcached >= 0.1.0)

Memcached::add — Add an item under a new key

설명

public bool Memcached::add ( string $key , mixed $value [, int $expiration ] )

Memcached::add() is similar to Memcached::set(), but the operation fails if the key already exists on the server.

인수

key: 값을 저장할 키.
value: 저장할 값.
expiration: 만료 시간, 기본값은 0. 자세한 정보는 만료 시간을 참고하십시오.

반환값

성공 시 TRUE를, 실패 시 FALSE를 반환합니다. The Memcached::getResultCode() will return Memcached::RES_NOTSTORED if the key already exists.

참고

Memcached::addByKey() - Add an item under a new key on a specific server
Memcached::set() - Store an item
Memcached::replace() - Replace the item under an existing key

add a note

User Contributed Notes 2 notes

down

ilya dot chase at yandex dot ru ¶

4 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

-33

zhoujunwen888 at 126 dot com ¶

8 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