Memcache::add

memcache_add

(PECL memcache >= 0.2.0)

Memcache::add -- memcache_add — Adiciona um item ao servidor

Descrição

Memcache::add(
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool
memcache_add(
    Memcache $memcache,
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool

Memcache::add() armazena a variável var com a chave key somente se tal chave ainda não existir no servidor.

Parâmetros

key
A chave que será associada ao item.
var
A variável a ser armazenada. Strings e inteiros são armazenados como estão, outros tipos são armazenados serializados.
flag
Use MEMCACHE_COMPRESSED para armazenar o item compactado (usa zlib).
expire
Tempo de expiração do item. Se for igual a zero, o item nunca irá expirar. Pode-se também usar o timestamp Unix ou um número de segundos começando no horário atual, mas no último caso o número de segundos não pode exceder 2592000 (30 dias).

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha. Retorna false se tal chave já existir. Para o resto Memcache::add() se comporta similarmente a Memcache::set().

Exemplos

Exemplo #1 Exemplo de Memcache::add()

<?php

$memcache_obj = memcache_connect("localhost", 11211);

/* API procedural */
memcache_add($memcache_obj, 'chave_var', 'variável de teste', false, 30);

/* API orientada a objeto */
$memcache_obj->add('chave_var', 'variável de teste', false, 30);

?>

Veja Também