(extends Query_Builder_Where)
The Query_Builder_Insert class handles all the insert operations for the query building process. It extends the
Query_Builder_Where class, so all the methods are inherited.
The table method sets/changes the table to insert into.
Static |
No |
Parameters |
Param |
Type |
Default |
Description |
$table |
string |
required |
the table name |
|
Returns |
Returns the current instance. |
Example |
$query = DB::insert('users');
$query->table('admins');
|
The columns method sets/changes the columns to insert.
Static |
No |
Parameters |
Param |
Type |
Default |
Description |
$columns |
array |
required |
an array of column names |
|
Returns |
Returns the current instance. |
Example |
$query = DB::insert('users');
$query->columns(array(
'name',
'surname',
'email')
);
|
The values method appends the values to insert.
Static |
No |
Parameters |
Param |
Type |
Default |
Description |
$values |
array |
required |
list of values |
|
Returns |
Returns the current instance. |
Example |
$query = DB::insert('users');
$query->columns(array(
'name',
'surname',
'email',
));
$query->values(array(
'John',
'Doe',
'john@doe.com',
));
|
The set method sets the columns and appends the values to insert.
Static |
No |
Parameters |
Param |
Type |
Default |
Description |
$pairs |
array |
required |
associative array of columns and values |
|
Returns |
Returns the current instance. |
Example |
$query = DB::insert('users');
$query->set(array(
'name' => 'John',
'surname' => 'Doe',
'email' => 'john@doe.com',
));
|
The limit method returns the insert SQL query as a string.
Static |
No |
Parameters |
Param |
Type |
Default |
Description |
$db |
object |
required |
A database connection |
|
Returns |
Returns the SQL query as a string. |
Example |
$query = DB::select('*')->from('users');
$query->limit(10);
$query->offset(5);
$connection = Database_Connection::instance();
$sql = $query->compile($connection);
|
The reset method resets all values of the current instance.
Static |
No |
Parameters |
None
|
Returns |
Returns the current instance. |
Example |
$query = DB::insert('users');
$query->set(array(
'name' => 'John',
'surname' => 'Doe',
));
$query->reset();
$query->table('admins')->set(array(
'name' => 'Mark',
'surname' => 'Handriks'
));
|