function StatementWrapper::execute

Same name and namespace in other branches
  1. 9 core/lib/Drupal/Core/Database/StatementWrapper.php \Drupal\Core\Database\StatementWrapper::execute()

Executes a prepared statement.

Parameters

$args: An array of values with as many elements as there are bound parameters in the SQL statement being executed. This can be NULL.

$options: An array of options for this query.

Return value

bool TRUE on success, or FALSE on failure.

Overrides StatementInterface::execute

File

core/lib/Drupal/Core/Database/StatementWrapper.php, line 88

Class

StatementWrapper
Implementation of StatementInterface encapsulating PDOStatement.

Namespace

Drupal\Core\Database

Code

public function execute($args = [], $options = []) {
  if (isset($options['fetch'])) {
    if (is_string($options['fetch'])) {
      // \PDO::FETCH_PROPS_LATE tells __construct() to run before properties
      // are added to the object.
      $this->setFetchMode(\PDO::FETCH_CLASS | \PDO::FETCH_PROPS_LATE, $options['fetch']);
    }
    else {
      $this->setFetchMode($options['fetch']);
    }
  }
  if ($this->connection
    ->isEventEnabled(StatementExecutionStartEvent::class)) {
    $startEvent = new StatementExecutionStartEvent(spl_object_id($this), $this->connection
      ->getKey(), $this->connection
      ->getTarget(), $this->getQueryString(), $args ?? [], $this->connection
      ->findCallerFromDebugBacktrace());
    $this->connection
      ->dispatchEvent($startEvent);
  }
  $return = $this->clientStatement
    ->execute($args);
  if (isset($startEvent) && $this->connection
    ->isEventEnabled(StatementExecutionEndEvent::class)) {
    $this->connection
      ->dispatchEvent(new StatementExecutionEndEvent($startEvent->statementObjectId, $startEvent->key, $startEvent->target, $startEvent->queryString, $startEvent->args, $startEvent->caller, $startEvent->time));
  }
  return $return;
}

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