function Update::execute

Same name in this branch
  1. 10 core/modules/pgsql/src/Driver/Database/pgsql/Update.php \Drupal\pgsql\Driver\Database\pgsql\Update::execute()
Same name and namespace in other branches
  1. 9 core/modules/pgsql/src/Driver/Database/pgsql/Update.php \Drupal\pgsql\Driver\Database\pgsql\Update::execute()
  2. 9 core/lib/Drupal/Core/Database/Query/Update.php \Drupal\Core\Database\Query\Update::execute()
  3. 8.9.x core/lib/Drupal/Core/Database/Driver/pgsql/Update.php \Drupal\Core\Database\Driver\pgsql\Update::execute()
  4. 8.9.x core/lib/Drupal/Core/Database/Query/Update.php \Drupal\Core\Database\Query\Update::execute()
  5. 11.x core/modules/pgsql/src/Driver/Database/pgsql/Update.php \Drupal\pgsql\Driver\Database\pgsql\Update::execute()
  6. 11.x core/lib/Drupal/Core/Database/Query/Update.php \Drupal\Core\Database\Query\Update::execute()

Executes the UPDATE query.

Return value

int|null The number of rows matched by the update query. This includes rows that actually didn't have to be updated because the values didn't change.

Overrides Query::execute

1 method overrides Update::execute()
Update::execute in core/modules/pgsql/src/Driver/Database/pgsql/Update.php
Executes the UPDATE query.

File

core/lib/Drupal/Core/Database/Query/Update.php, line 122

Class

Update
General class for an abstracted UPDATE operation.

Namespace

Drupal\Core\Database\Query

Code

public function execute() {
  // Expressions take priority over literal fields, so we process those first
  // and remove any literal fields that conflict.
  $fields = $this->fields;
  $update_values = [];
  foreach ($this->expressionFields as $field => $data) {
    if (!empty($data['arguments'])) {
      $update_values += $data['arguments'];
    }
    if ($data['expression'] instanceof SelectInterface) {
      $data['expression']->compile($this->connection, $this);
      $update_values += $data['expression']->arguments();
    }
    unset($fields[$field]);
  }
  // Because we filter $fields the same way here and in __toString(), the
  // placeholders will all match up properly.
  $max_placeholder = 0;
  foreach ($fields as $value) {
    $update_values[':db_update_placeholder_' . $max_placeholder++] = $value;
  }
  if (count($this->condition)) {
    $this->condition
      ->compile($this->connection, $this);
    $update_values = array_merge($update_values, $this->condition
      ->arguments());
  }
  $stmt = $this->connection
    ->prepareStatement((string) $this, $this->queryOptions, TRUE);
  try {
    $stmt->execute($update_values, $this->queryOptions);
    return $stmt->rowCount();
  } catch (\Exception $e) {
    $this->connection
      ->exceptionHandler()
      ->handleExecutionException($e, $stmt, $update_values, $this->queryOptions);
  }
}

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