function DatabaseStorage::doSetIfNotExists

Same name in other branches
  1. 9 core/lib/Drupal/Core/KeyValueStore/DatabaseStorage.php \Drupal\Core\KeyValueStore\DatabaseStorage::doSetIfNotExists()
  2. 11.x core/lib/Drupal/Core/KeyValueStore/DatabaseStorage.php \Drupal\Core\KeyValueStore\DatabaseStorage::doSetIfNotExists()

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

This will be called by setIfNotExists() within a try block.

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.

1 call to DatabaseStorage::doSetIfNotExists()
DatabaseStorage::setIfNotExists in core/lib/Drupal/Core/KeyValueStore/DatabaseStorage.php
Saves a value for a given key if it does not exist yet.

File

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

Class

DatabaseStorage
Defines a default key/value store implementation.

Namespace

Drupal\Core\KeyValueStore

Code

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

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