8.3.x database.inc db_delete($table, array $options = [])
8.0.x database.inc db_delete($table, array $options = array())
8.1.x database.inc db_delete($table, array $options = array())
8.2.x database.inc db_delete($table, array $options = array())
8.4.x database.inc db_delete($table, array $options = [])
7.x database.inc db_delete($table, array $options = array())

Returns a new DeleteQuery object for the active database.

Parameters

string $table: The table from which to delete.

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

Return value

\Drupal\Core\Database\Query\Delete A new Delete 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 delete() on it. For example, $injected_database->delete($table, $options);

See also

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

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

Related topics

28 calls to db_delete()
DatabaseStorageTest::delete in core/tests/Drupal/KernelTests/Core/Config/Storage/DatabaseStorageTest.php
DbLogTest::testFilter in core/modules/dblog/src/Tests/DbLogTest.php
Tests the database log filter functionality at admin/reports/dblog.
dblog_cron in core/modules/dblog/dblog.module
Implements hook_cron().
DeleteTruncateTest::testSimpleDelete in core/tests/Drupal/KernelTests/Core/Database/DeleteTruncateTest.php
Confirms that we can delete a single record successfully.
DeleteTruncateTest::testSpecialColumnDelete in core/tests/Drupal/KernelTests/Core/Database/DeleteTruncateTest.php
Confirms that we can delete a single special column name record successfully.

... See full list

File

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

Code

function db_delete($table, array $options = array()) {
  if (empty($options['target']) || $options['target'] == 'replica') {
    $options['target'] = 'default';
  }
  return Database::getConnection($options['target'])->delete($table, $options);
}