Query_Builder_Insert クラス

(extends Query_Builder_Where)

Query_Builder_Insert クラスは、クエリ構築のためのすべてのインサート 操作を扱います。 これは、Query_Builder_Where クラスを拡張しており、すべてのメソッドが継承されます。

table($table)

tableメソッドは、インサートするテーブルをセット/変更します。

静的 No
パラメータ
パラメータ 型 規定値 説明
$table string 必須 the table name
返り値 Returns the current instance.
例 
// prepare an insert statement
$query = DB::insert('users');

// Update the table to insert into
$query->table('admins');

// INSERT INTO `admins` ...

columns(array $columns)

columnsメソッドは、インサートするカラムをセット/変更します。

静的 No
パラメータ
パラメータ 型 規定値 説明
$columns array 必須 an array of column names
返り値 Returns the current instance.
例 
// prepare an insert statement
$query = DB::insert('users');

// Set the columns
$query->columns(array(
	'name',
	'surname',
	'email')
);

// INSERT INTO `users` (`name`, `surname`, `email`)

values(array $values)

valuesメソッドは、インサートする値を追加します。

静的 No
パラメータ
パラメータ 型 規定値 説明
$values array 必須 list of values
返り値 Returns the current instance.
例 
// prepare an insert statement
$query = DB::insert('users');

// Set the columns
$query->columns(array(
	'name',
	'surname',
	'email',
));

// Set the values

$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 必須 カラム名と値の連想配列
返り値 Returns the current instance.
例 
// prepare an insert statement
$query = DB::insert('users');

// Set the columns and vales
$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 必須 A database connection
返り値 Returns the SQL query as a string.
例 
// prepare an insert statement
$query = DB::select('*')->from('users');

// Set the limit and offset
$query->limit(10);
$query->offset(5);

// Get the database connection
$connection = Database_Connection::instance();

// Get the sql query
$sql = $query->compile($connection);

reset()

resetメソッドは、現在のインスタンスのすべての値をリセットします。

静的 No
パラメータ None
返り値 Returns the current instance.
例 
// prepare an insert statement
$query = DB::insert('users');

// Set some values
$query->set(array(
	'name' => 'John',
	'surname' => 'Doe',
));

// Reset it
$query->reset();

// Set the new values
$query->table('admins')->set(array(
	'name' => 'Mark',
	'surname' => 'Handriks'
));

// The SQL query will now be:
// INSERT INTO `admins` (`name`, `surname`) VALUES ("Mark", "Hendriks")