function Connection::nextId

File

core/modules/mysql/src/Driver/Database/mysql/Connection.php, line 343

Class

Connection

MySQL implementation of \Drupal\Core\Database\Connection.

Namespace

Code

public function nextId($existing_id = 0) {
    @trigger_error('Drupal\\Core\\Database\\Connection::nextId() is deprecated in drupal:10.2.0 and is removed from drupal:11.0.0. Modules should use instead the keyvalue storage for the last used id. See https://www.drupal.org/node/3349345', E_USER_DEPRECATED);
    $this->query('INSERT INTO {sequences} () VALUES ()');
    $new_id = $this->lastInsertId();
    // This should only happen after an import or similar event.
    if ($existing_id >= $new_id) {
        // If we INSERT a value manually into the sequences table, on the next
        // INSERT, MySQL will generate a larger value. However, there is no way
        // of knowing whether this value already exists in the table. MySQL
        // provides an INSERT IGNORE which would work, but that can mask problems
        // other than duplicate keys. Instead, we use INSERT ... ON DUPLICATE KEY
        // UPDATE in such a way that the UPDATE does not do anything. This way,
        // duplicate keys do not generate errors but everything else does.
        $this->query('INSERT INTO {sequences} (value) VALUES (:value) ON DUPLICATE KEY UPDATE value = value', [
            ':value' => $existing_id,
        ]);
        $this->query('INSERT INTO {sequences} () VALUES ()');
        $new_id = $this->lastInsertId();
    }
    $this->needsCleanup = TRUE;
    return $new_id;
}