DrupalAPI.de

1. drupal
   1. drupal6

Check if lock acquired by a different process may be available.

If an existing lock has expired, it is removed.

Übergabeparameter

$name The name of the lock.

Rückgabewert

TRUE if there is no lock or it was removed, FALSE otherwise.

Verwandte Themen

Functions to coordinate long-running operations across requests.

In most environments, multiple Drupal page requests (a.k.a. threads or processes) will execute in parallel. This leads to potential conflicts or race conditions when two requests execute the same code at the same time. A common example of this is a…

Code

includes/lock.inc, line 148

<?php
function lock_may_be_available($name) {
  $lock = db_fetch_array(db_query("SELECT expire, value FROM {semaphore} WHERE name = '%s'", $name));
  if (!$lock) {
    return TRUE;
  }
  $expire = (float) $lock['expire'];
  list($usec, $sec) = explode(' ', microtime());
  $now = (float) $usec + (float) $sec;
  if ($now > $lock['expire']) {
    // We check two conditions to prevent a race condition where another
    // request acquired the lock and set a new expire time.  We add a small
    // number to $expire to avoid errors with float to string conversion.
    db_query("DELETE FROM {semaphore} WHERE name = '%s' AND value = '%s' AND expire <= %f", $name, $lock['value'], 0.0001 + $expire);
    return (bool) db_affected_rows();
  }
  return FALSE;
}
?>