Memcached::increment

(PECL memcached >= 0.1.0)

Memcached::increment — Incrementa o valor do item numérico

Descrição

public Memcached::increment(
    string $key,
    int $offset = 1,
    int $initial_value = 0,
    int $expiry = 0
): int|false

Memcached::increment() incrementa o valor de um item numérico pelo offset especificado. Se o valor do item não for numérico, ocorrerá um erro. Memcached::increment() irá definir o item para o parâmetro initial_value se a key não existir.

Parâmetros

key

A key do item a incrementar.

offset

A quantia pela qual incrementar o valor do item.

initial_value

O valor para definir o item se ele não existir no momento.

expiry

O tempo de expiração a ser definido no item.

Valor Retornado

Retorna o valor do novo item em caso de sucesso ou false em caso de falha.

Exemplos

Example #1 Memcached::increment() exemplo

<?php
$m = new Memcached();
$m->addServer('localhost', 11211);

$m->set('counter', 0);
$m->increment('counter');
$n = $m->increment('counter', 10);
var_dump($n);

$m->set('counter', 'abc');
$n = $m->increment('counter');
// ^ falhará devido ao valor do item não ser numérico
var_dump($n);
?>

O exemplo acima produzirá:

int(11)
bool(false)

Veja Também