class InsertQuery_mysql
@file Query code for MySQL embedded database engine.
Hierarchy
- class \Query implements \QueryPlaceholderInterface
- class \InsertQuery extends \Query
- class \InsertQuery_mysql extends \InsertQuery
- class \InsertQuery extends \Query
Expanded class hierarchy of InsertQuery_mysql
Related topics
File
-
includes/
database/ mysql/ query.inc, line 14
View source
class InsertQuery_mysql extends InsertQuery {
public function execute() {
if (!$this->preExecute()) {
return NULL;
}
// If we're selecting from a SelectQuery, finish building the query and
// pass it back, as any remaining options are irrelevant.
if (empty($this->fromQuery)) {
$max_placeholder = 0;
$values = array();
foreach ($this->insertValues as $insert_values) {
foreach ($insert_values as $value) {
$values[':db_insert_placeholder_' . $max_placeholder++] = $value;
}
}
}
else {
$values = $this->fromQuery
->getArguments();
}
$last_insert_id = $this->connection
->query((string) $this, $values, $this->queryOptions);
// Re-initialize the values array so that we can re-use this query.
$this->insertValues = array();
return $last_insert_id;
}
public function __toString() {
// Create a sanitized comment string to prepend to the query.
$comments = $this->connection
->makeComment($this->comments);
// Default fields are always placed first for consistency.
$insert_fields = array_merge($this->defaultFields, $this->insertFields);
if (method_exists($this->connection, 'escapeFields')) {
$insert_fields = $this->connection
->escapeFields($insert_fields);
}
// If we're selecting from a SelectQuery, finish building the query and
// pass it back, as any remaining options are irrelevant.
if (!empty($this->fromQuery)) {
$insert_fields_string = $insert_fields ? ' (' . implode(', ', $insert_fields) . ') ' : ' ';
return $comments . 'INSERT INTO {' . $this->table . '}' . $insert_fields_string . $this->fromQuery;
}
$query = $comments . 'INSERT INTO {' . $this->table . '} (' . implode(', ', $insert_fields) . ') VALUES ';
$max_placeholder = 0;
$values = array();
if (count($this->insertValues)) {
foreach ($this->insertValues as $insert_values) {
$placeholders = array();
// Default fields aren't really placeholders, but this is the most convenient
// way to handle them.
$placeholders = array_pad($placeholders, count($this->defaultFields), 'default');
$new_placeholder = $max_placeholder + count($insert_values);
for ($i = $max_placeholder; $i < $new_placeholder; ++$i) {
$placeholders[] = ':db_insert_placeholder_' . $i;
}
$max_placeholder = $new_placeholder;
$values[] = '(' . implode(', ', $placeholders) . ')';
}
}
else {
// If there are no values, then this is a default-only query. We still need to handle that.
$placeholders = array_fill(0, count($this->defaultFields), 'default');
$values[] = '(' . implode(', ', $placeholders) . ')';
}
$query .= implode(', ', $values);
return $query;
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title | Overrides |
---|---|---|---|---|---|
InsertQuery::$defaultFields | protected | property | An array of fields that should be set to their database-defined defaults. | ||
InsertQuery::$fromQuery | protected | property | A SelectQuery object to fetch the rows that should be inserted. | ||
InsertQuery::$insertFields | protected | property | An array of fields on which to insert. | ||
InsertQuery::$insertValues | protected | property | A nested array of values to insert. | ||
InsertQuery::$table | protected | property | The table on which to insert. | ||
InsertQuery::fields | public | function | Adds a set of field->value pairs to be inserted. | ||
InsertQuery::from | public | function | Sets the fromQuery on this InsertQuery object. | ||
InsertQuery::preExecute | public | function | Preprocesses and validates the query. | ||
InsertQuery::useDefaults | public | function | Specifies fields for which the database defaults should be used. | ||
InsertQuery::values | public | function | Adds another set of values to the query to be inserted. | ||
InsertQuery::__construct | public | function | Constructs an InsertQuery object. | Overrides Query::__construct | |
InsertQuery_mysql::execute | public | function | Executes the insert query. | Overrides InsertQuery::execute | |
InsertQuery_mysql::__toString | public | function | Implements PHP magic __toString method to convert the query to a string. | Overrides InsertQuery::__toString | |
Query::$comments | protected | property | An array of comments that can be prepended to a query. | ||
Query::$connection | protected | property | The connection object on which to run this query. | ||
Query::$connectionKey | protected | property | The key of the connection object. | ||
Query::$connectionTarget | protected | property | The target of the connection object. | ||
Query::$nextPlaceholder | protected | property | The placeholder counter. | ||
Query::$queryOptions | protected | property | The query options to pass on to the connection object. | ||
Query::$uniqueIdentifier | protected | property | A unique identifier for this query object. | ||
Query::comment | public | function | Adds a comment to the query. | ||
Query::getComments | public | function | Returns a reference to the comments array for the query. | ||
Query::nextPlaceholder | public | function | Gets the next placeholder value for this query object. | Overrides QueryPlaceholderInterface::nextPlaceholder | |
Query::uniqueIdentifier | public | function | Returns a unique identifier for this object. | Overrides QueryPlaceholderInterface::uniqueIdentifier | |
Query::__clone | public | function | Implements the magic __clone function. | 1 | |
Query::__sleep | public | function | Implements the magic __sleep function to disconnect from the database. | ||
Query::__wakeup | public | function | Implements the magic __wakeup function to reconnect to the database. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.