Full ELMS Learning Network documentation
function db_query
Error message
User warning: The following module is missing from the file system: theme/theme. For information about how to fix this, see the documentation page. in _drupal_trigger_error_with_delayed_logging() (line 1156 of /var/www/html/elmsln_community/api.elmsln.org/includes/bootstrap.inc).cis7 database.inc | db_query($query, array $args = array(), array $options = array()) |
cle7 database.inc | db_query($query, array $args = array(), array $options = array()) |
elmsmedia7 database.inc | db_query($query, array $args = array(), array $options = array()) |
icor7 database.inc | db_query($query, array $args = array(), array $options = array()) |
meedjum_blog7 database.inc | db_query($query, array $args = array(), array $options = array()) |
mooc7 database.inc | db_query($query, array $args = array(), array $options = array()) |
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
$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.
$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.
$options: An array of options to control how the query operates.
Return value
DatabaseStatementInterface A prepared statement object, already executed.
See also
DatabaseConnection::defaultOptions()
Related topics
- actions_do in includes/
actions.inc - Performs a given list of actions by executing their callback functions.
- actions_function_lookup in includes/
actions.inc - Returns an action array key (function or ID), given its hash.
- actions_get_all_actions in includes/
actions.inc - Retrieves all action instances from the database.
- actions_load in includes/
actions.inc - Retrieves a single action from the database.
- actions_synchronize in includes/
actions.inc - Synchronizes actions that are provided by modules in hook_action_info().
- drupal_get_filename in includes/
bootstrap.inc - Returns and optionally sets the filename for a system resource.
- httprl_variable_get in sites/
all/ modules/ ulmus/ httprl/ httprl.module - Returns a persistent variable.
- _drupal_decode_exception in includes/
errors.inc - Decodes an exception and retrieves the correct caller.
File
- includes/
database/ database.inc, line 2342 - 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);
}