Memcached::deleteByKey
Delete an item from a specific server
Description
public bool Memcached::deleteByKey(string $server_key
, string $key
, int $time
= 0)
Parameters
-
server_key
-
The key identifying the server to store the value on or retrieve it from. Instead of hashing on the actual key for the item, we hash on the server key when deciding which memcached server to talk to. This allows related items to be grouped together on a single server for efficiency with multi operations.
-
key
-
The key to be deleted.
-
time
-
The amount of time the server will wait to delete the item.
Note:
As of memcached 1.3.0 (released 2009) this feature is no longer
supported. Passing a non-zero time
will cause
the deletion to fail. Memcached::getResultCode
will return MEMCACHED_INVALID_ARGUMENTS
.
Return Values
Returns true
on success or false
on failure.
The Memcached::getResultCode will return
Memcached::RES_NOTFOUND
if the key does not exist.
See Also
- Memcached::delete
- Memcached::deleteMulti
- Memcached::deleteMultiByKey