@file Query code for MySQL embedded database engine.
Expanded class hierarchy of InsertQuery_mysql
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 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;
}
}
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
InsertQuery:: |
protected | property | An array of fields that should be set to their database-defined defaults. | |
InsertQuery:: |
protected | property | A SelectQuery object to fetch the rows that should be inserted. | |
InsertQuery:: |
protected | property | An array of fields on which to insert. | |
InsertQuery:: |
protected | property | A nested array of values to insert. | |
InsertQuery:: |
protected | property | The table on which to insert. | |
InsertQuery:: |
public | function | Adds a set of field->value pairs to be inserted. | |
InsertQuery:: |
public | function | Sets the fromQuery on this InsertQuery object. | |
InsertQuery:: |
public | function | Preprocesses and validates the query. | |
InsertQuery:: |
public | function | Specifies fields for which the database defaults should be used. | |
InsertQuery:: |
public | function | Adds another set of values to the query to be inserted. | |
InsertQuery:: |
public | function |
Constructs an InsertQuery object. Overrides Query:: |
|
InsertQuery_mysql:: |
public | function |
Executes the insert query. Overrides InsertQuery:: |
|
InsertQuery_mysql:: |
public | function |
Implements PHP magic __toString method to convert the query to a string. Overrides InsertQuery:: |
|
Query:: |
protected | property | An array of comments that can be prepended to a query. | |
Query:: |
protected | property | The connection object on which to run this query. | |
Query:: |
protected | property | The key of the connection object. | |
Query:: |
protected | property | The target of the connection object. | |
Query:: |
protected | property | The placeholder counter. | |
Query:: |
protected | property | The query options to pass on to the connection object. | |
Query:: |
protected | property | A unique identifier for this query object. | |
Query:: |
public | function | Adds a comment to the query. | |
Query:: |
public | function | Returns a reference to the comments array for the query. | |
Query:: |
public | function |
Gets the next placeholder value for this query object. Overrides QueryPlaceholderInterface:: |
|
Query:: |
public | function |
Returns a unique identifier for this object. Overrides QueryPlaceholderInterface:: |
|
Query:: |
public | function | Implements the magic __clone function. | 1 |
Query:: |
public | function | Implements the magic __sleep function to disconnect from the database. | |
Query:: |
public | function | Implements the magic __wakeup function to reconnect to the database. |