DocumentationHackReferenceClassMCRouterdel

MCRouter::del

Delete a key

public function del(
  string $key,
): Awaitable<void>;

Parameters

string $key - Key to delete

Returns

Awaitable<void>

Examples

The following example uses MCRouter::del to delete a key from the memcached server. Once the key is deleted, it is no longer accessible. Nor can you delete a non-existing key.

function get_simple_mcrouter(): \MCRouter {
  $servers = Vector {\getenv('HHVM_TEST_MCROUTER')};
  $mc = \MCRouter::createSimple($servers);
  return $mc;
}

async function set_value(
  \MCRouter $mc,
  string $key,
  string $value,
): Awaitable<void> {
  // can also pass optional int flags and int expiration time (in seconds)
  await $mc->set($key, $value);
}

async function del_key(\MCRouter $mc, string $key): Awaitable<void> {
  // can also pass optional int flags and int expiration time (in seconds)
  await $mc->del($key);
}

async function run(): Awaitable<void> {
  $mc = get_simple_mcrouter();
  $unique_key = \str_shuffle('ABCDEFGHIJKLMN');
  await set_value($mc, $unique_key, "Hi");
  $val = await $mc->get($unique_key);
  \var_dump($val);
  await del_key($mc, $unique_key);
  try {
    // Try getting the key after it has been deleted
    $val = await $mc->get($unique_key);
    \var_dump($val); // Not going to get here.
  } catch (\MCRouterException $ex) {
    \var_dump($ex->getMessage()); // We should get here because key was deleted
  }
}

\HH\Asio\join(run());

Output

string(2) "Hi"

Fatal error: Uncaught exception 'MCRouterException' with message 'delete failed with result mc_res_notfound' in /data/users/joelm/user-documentation/api-examples/class.MCRouter/del/001-basic-usage.php:38
Stack trace:
#0 /data/users/joelm/user-documentation/api-examples/class.MCRouter/del/001-basic-usage.php(38): HH\Asio\join()
#1 {main}