8.5.x database.inc db_select($table, $alias = NULL, array $options = [])
8.0.x database.inc db_select($table, $alias = NULL, array $options = array())
8.1.x database.inc db_select($table, $alias = NULL, array $options = array())
8.2.x database.inc db_select($table, $alias = NULL, array $options = array())
8.3.x database.inc db_select($table, $alias = NULL, array $options = [])
8.4.x database.inc db_select($table, $alias = NULL, array $options = [])
8.6.x database.inc db_select($table, $alias = NULL, array $options = [])
7.x database.inc db_select($table, $alias = NULL, array $options = array())

Returns a new SelectQuery object for the active database.

Parameters

string|\Drupal\Core\Database\Query\SelectInterface $table: The base table for this query. May be a string or another SelectInterface object. If a SelectInterface object is passed, it will be used as a subselect.

string $alias: (optional) The alias for the base table of this query.

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

Return value

\Drupal\Core\Database\Query\Select A new Select object for this connection.

Deprecated

as of Drupal 8.0.x, will be removed in Drupal 9.0.0. Instead, get a database connection injected into your service from the container and call select() on it. For example, $injected_database->select($table, $alias, $options);

See also

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

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

Related topics

68 calls to db_select()
AlterTest::testAlterChangeConditional in core/tests/Drupal/KernelTests/Core/Database/AlterTest.php
Tests that we can alter a query's conditionals.
AlterTest::testAlterChangeFields in core/tests/Drupal/KernelTests/Core/Database/AlterTest.php
Tests that we can alter the fields of a query.
AlterTest::testAlterExpression in core/tests/Drupal/KernelTests/Core/Database/AlterTest.php
Tests that we can alter expressions in the query.
AlterTest::testAlterRemoveRange in core/tests/Drupal/KernelTests/Core/Database/AlterTest.php
Tests that we can remove a range() value from a query.
AlterTest::testAlterWithJoin in core/tests/Drupal/KernelTests/Core/Database/AlterTest.php
Tests that we can alter the joins on a query.

... See full list

1 string reference to 'db_select'
DrupalPractice_Sniffs_FunctionCalls_DbSelectBracesSniff::registerFunctionNames in vendor/drupal/coder/coder_sniffer/DrupalPractice/Sniffs/FunctionCalls/DbSelectBracesSniff.php
Returns an array of function names this test wants to listen for.

File

core/includes/database.inc, line 291
Core systems for the database layer.

Code

function db_select($table, $alias = NULL, array $options = []) {
  if (empty($options['target'])) {
    $options['target'] = 'default';
  }
  return Database::getConnection($options['target'])
    ->select($table, $alias, $options);
}