function DatabaseStorage::setIfNotExists

Same name and namespace in other branches
  1. 9 core/lib/Drupal/Core/KeyValueStore/DatabaseStorage.php \Drupal\Core\KeyValueStore\DatabaseStorage::setIfNotExists()
  2. 8.9.x core/lib/Drupal/Core/KeyValueStore/DatabaseStorage.php \Drupal\Core\KeyValueStore\DatabaseStorage::setIfNotExists()
  3. 11.x core/lib/Drupal/Core/KeyValueStore/DatabaseStorage.php \Drupal\Core\KeyValueStore\DatabaseStorage::setIfNotExists()

Saves a value for a given key if it does not exist yet.

Parameters

string $key: The key of the data to store.

mixed $value: The data to store.

Return value

bool TRUE if the data was set, FALSE if it already existed.

Overrides KeyValueStoreInterface::setIfNotExists

File

core/lib/Drupal/Core/KeyValueStore/DatabaseStorage.php, line 186

Class

DatabaseStorage
Defines a default key/value store implementation.

Namespace

Drupal\Core\KeyValueStore

Code

public function setIfNotExists($key, $value) {
  try {
    return $this->doSetIfNotExists($key, $value);
  } catch (\Exception $e) {
    // If there was an exception, try to create the table.
    if ($this->ensureTableExists()) {
      return $this->doSetIfNotExists($key, $value);
    }
    else {
      throw $e;
    }
  }
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.