Query_Builder_Insert クラス
(Query_Builder_Where の拡張)
Query_Builder_Insert クラスは、クエリ構築のためのすべてのインサート 操作を扱います。
これは、Query_Builder_Where クラスを拡張しており、すべてのメソッドが継承されます。
table($table)
table メソッドは、インサートするテーブルをセット/変更します。
静的 |
No |
パラメータ |
パラメータ |
型 |
デフォルト |
説明 |
$table |
string |
必須 |
テーブル名 |
|
返り値 |
現在のインスタンス |
例 |
// insert 文を準備します
$query = DB::insert('users');
// 挿入するテーブル名を更新
$query->table('admins');
// INSERT INTO `admins` ...
|
columns(array $columns)
columns メソッドは、インサートするカラムをセット/変更します。
静的 |
No |
パラメータ |
パラメータ |
型 |
デフォルト |
説明 |
$columns |
array |
必須 |
カラム名の配列 |
|
返り値 |
現在のインスタンス |
例 |
// insert 文を準備します
$query = DB::insert('users');
// カラム名をセット
$query->columns(array(
'name',
'surname',
'email')
);
// INSERT INTO `users` (`name`, `surname`, `email`)
|
values(array $values)
values メソッドは、インサートする値を追加します。
静的 |
No |
パラメータ |
パラメータ |
型 |
デフォルト |
説明 |
$values |
array |
必須 |
値のリスト |
|
返り値 |
現在のインスタンス |
例 |
// insert 文を準備します
$query = DB::insert('users');
// カラム名をセット
$query->columns(array(
'name',
'surname',
'email',
));
// 値をセット
$query->values(array(
'John',
'Doe',
'john@doe.com',
));
// INSERT INTO `users` (`name`, `surname`, `email`) VALUES ("John", "Doe", "john@doe.com")
|
set(array $pairs)
set メソッドは、インサートするカラムと値を追加します。
静的 |
No |
パラメータ |
パラメータ |
型 |
デフォルト |
説明 |
$pairs |
array |
必須 |
カラム名と値の連想配列 |
|
返り値 |
現在のインスタンス |
例 |
// insert 文を準備します
$query = DB::insert('users');
// カラム名と値をセット
$query->set(array(
'name' => 'John',
'surname' => 'Doe',
'email' => 'john@doe.com',
));
// INSERT INTO `users` (`name`, `surname`, `email`) VALUES ("John", "Doe", "john@doe.com")
|
compile(\Database_Connection$db)
compile メソッドは、インサートを行うSQL クエリを文字列で返却します。
静的 |
No |
パラメータ |
パラメータ |
型 |
デフォルト |
説明 |
$db |
object |
必須 |
データベースコネクション |
|
返り値 |
SQL クエリの文字列 |
例 |
// insert 文を準備します
$query = DB::select('*')->from('users');
// Set the limit and offset
$query->limit(10);
$query->offset(5);
// データベースコネクションを取得
$connection = Database_Connection::instance();
// SQLクエリを取得
$sql = $query->compile($connection);
|
reset()
resetメソッドは、現在のインスタンスのすべての値をリセットします。
静的 |
No |
パラメータ |
None
|
返り値 |
現在のインスタンス |
例 |
// insert 文を準備します
$query = DB::insert('users');
// いくつかの値をセット
$query->set(array(
'name' => 'John',
'surname' => 'Doe',
));
// リセット
$query->reset();
// 新しい値をセット
$query->table('admins')->set(array(
'name' => 'Mark',
'surname' => 'Handriks'
));
// The SQL query will now be:
// INSERT INTO `admins` (`name`, `surname`) VALUES ("Mark", "Hendriks")
|