PHP 8.3.4 Released!

Memcached::add

(PECL memcached >= 0.1.0)

Memcached::addAdd an item under a new key

Description

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

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

Parameters

key

The key under which to store the value.

value

The value to store.

expiration

The expiration time, defaults to 0. See Expiration Times for more info.

Return Values

Returns true on success or false on failure. The Memcached::getResultCode() will return Memcached::RES_NOTSTORED if the key already exists.

See Also

add a note

User Contributed Notes 2 notes

up
3
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.
up
-42
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");
}

?>
To Top