public function DatabaseStorage::setIfNotExists

public DatabaseStorage::setIfNotExists($key, $value)

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 122

Class

DatabaseStorage
Defines a default key/value store implementation.

Namespace

Drupal\Core\KeyValueStore

Code

public function setIfNotExists($key, $value) {
  $result = $this->connection->merge($this->table)
    ->insertFields(array(
      'collection' => $this->collection,
      'name' => $key,
      'value' => $this->serializer->encode($value),
    ))
    ->condition('collection', $this->collection)
    ->condition('name', $key)
    ->execute();
  return $result == Merge::STATUS_INSERT;
}

© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.
https://api.drupal.org/api/drupal/core!lib!Drupal!Core!KeyValueStore!DatabaseStorage.php/function/DatabaseStorage::setIfNotExists/8.1.x