function db_query in Zircon Profile 8.0

Same name and namespace in other branches

1. 8 core/includes/database.inc \db_query()

Executes an arbitrary query string against the active database.

Use this function for SELECT queries if it is just a simple query string. If the caller or other modules need to change the query, use db_select() instead.

Do not use this function for INSERT, UPDATE, or DELETE queries. Those should be handled via db_insert(), db_update() and db_delete() respectively.

Parameters

string|\Drupal\Core\Database\StatementInterface $query: The prepared statement query to run. Although it will accept both named and unnamed placeholders, named placeholders are strongly preferred as they are more self-documenting. If the argument corresponding to a placeholder is an array of values to be expanded, e.g. for an IN query, the placeholder should be named with a trailing bracket like :example[]

array $args: An array of values to substitute into the query. If the query uses named placeholders, this is an associative array in any order. If the query uses unnamed placeholders (?), this is an indexed array and the order must match the order of placeholders in the query string.

array $options: An array of options to control how the query operates.

Return value

\Drupal\Core\Database\StatementInterface A prepared statement object, already executed.

See also

\Drupal\Core\Database\Connection::query()

\Drupal\Core\Database\Connection::defaultOptions()

Related topics

33 calls to db_query()

AggregatorTestBase::updateFeedItems in core/modules/aggregator/src/Tests/AggregatorTestBase.php

Updates the feed items.

BasicSyntaxTest::testConcatFields in core/modules/system/src/Tests/Database/BasicSyntaxTest.php

Tests string concatenation with field values.

BasicSyntaxTest::testConcatLiterals in core/modules/system/src/Tests/Database/BasicSyntaxTest.php

Tests string concatenation.

BasicSyntaxTest::testConcatWsFields in core/modules/system/src/Tests/Database/BasicSyntaxTest.php

Tests string concatenation with separator, with field values.

BasicSyntaxTest::testConcatWsLiterals in core/modules/system/src/Tests/Database/BasicSyntaxTest.php

Tests string concatenation with separator.

... See full list

1 string reference to 'db_query'

Error::decodeException in core/lib/Drupal/Core/Utility/Error.php

Decodes an exception and retrieves the correct caller.

File

core/includes/database.inc, line 56

Core systems for the database layer.

Code

function db_query($query, array $args = array(), array $options = array()) {
  if (empty($options['target'])) {
    $options['target'] = 'default';
  }
  return Database::getConnection($options['target'])
    ->query($query, $args, $options);
}