function LinearHistory::add

Overrides CheckpointListInterface::add

File

core/lib/Drupal/Core/Config/Checkpoint/LinearHistory.php, line 103

Class

LinearHistory

A chronological list of Checkpoint objects.

Namespace

Code

public function add(string $id, string|\Stringable $label) : Checkpoint {
    if (isset($this->checkpoints[$id])) {
        throw new CheckpointExistsException(sprintf('Cannot create a checkpoint with the ID "%s" as it already exists', $id));
    }
    $checkpoint = new Checkpoint($id, $label, $this->time
        ->getCurrentTime(), $this->activeCheckpoint?->id);
    $this->checkpoints[$checkpoint->id] = $checkpoint;
    $this->activeCheckpoint = $checkpoint;
    $this->state
        ->set(self::CHECKPOINT_KEY, $this->checkpoints);
    return $checkpoint;
}