array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'memcached.increment.php', 1 => 'Memcached::increment', 2 => 'Incrémente numériquement un élément', ), 'up' => array ( 0 => 'class.memcached.php', 1 => 'Memcached', ), 'prev' => array ( 0 => 'memcached.getversion.php', 1 => 'Memcached::getVersion', ), 'next' => array ( 0 => 'memcached.incrementbykey.php', 1 => 'Memcached::incrementByKey', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/memcached/memcached/increment.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Memcached::increment

(PECL memcached >= 0.1.0)

Memcached::increment — Incrémente numériquement un élément

Description

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

Memcached::increment() incrémente la valeur numérique de offset unités. Si l'élément n'est pas numérique, une erreur sera émise. Memcached::increment() va définir l'élément à la valeur du paramètre initial_value si la clé n'existe pas.

Liste de paramètres

key

La clé de l'élément à incrémenter.

offset

La quantité avec laquelle augmenter l'élément.

initial_value

La valeur à utiliser pour définir l'élément s'il n'existe pas.

expiry

Le délai d'expiration pour définir l'élément.

Valeurs de retour

Retourne la nouvelle valeur de l'élément, en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 Exemple avec Memcached::getResultCode()

<?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');
// ^ va échouer en raison du fait que la valeur de l'élément n'est pas un numérique
var_dump($n);
?>

L'exemple ci-dessus va afficher :

int(11)
bool(false)

Voir aussi