php8.5
Home/ Manual/ memcached / memcached/ Memcached::casByKey

Memcached::casByKey

PHP function Edit on GitHub ✎

(PECL memcached >= 0.1.0)

Compare and swap an item on a specific server

Description

Memcached::casByKey(string|int|float $cas_token, string $server_key, string $key, mixed $value, int $expiration = 0): bool

Memcached::casByKey() is functionally equivalent to Memcached::cas, except that the free-form server_key can be used to map the key to a specific server. This is useful if you need to keep a bunch of related keys on a certain server.

Parameters

cas_token

Unique value associated with the existing item. Generated by memcache.

server_key

Server_key

key

Key

value

Value

expiration

Expiration

Return Values

Success The Memcached::getResultCode will return Memcached::RES_DATA_EXISTS if the item you are trying to store has been modified since you last fetched it.

See Also

  • Memcached::cas

Source: reference/memcached/memcached/casbykey.xml · from the official PHP manual (php/doc-en)