Query Builder Insert - 类別

优质

小牛编辑

116浏览

2023-12-01

（扩充 Query_Builder_Where）

Query_Builder_Insert 类别为查询建立程序处理所有 insert 操作，它扩充 Query_Builder_Where 类别，所以所有方法都继承。

table($table)

table 方法设定／改变要新增的资料表。

静态否

参数

参数	类型	预设	描述
`$table`	字串	必要	资料表名称

回传回传目前实例。

範例

// 预处理一个 insert 语句
$query = DB::insert('users');

// 更新要新增的资料表
$query->table('admins');

// INSERT INTO `admins` ...

columns(array $columns)

columns 方法设定／改变要新增的行。

静态否

参数

参数	类型	预设	描述
`$columns`	阵列	必要	行名称的阵列

回传回传目前实例。

範例

// 预处理一个 insert 语句
$query = DB::insert('users');

// 设定行
$query->columns(array(
	'name',
	'surname',
	'email')
);

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

values(array $values)

values 方法附加要新增的值。

静态否

参数

参数	类型	预设	描述
`$values`	阵列	必要	值的列表

回传回传目前实例。

範例

// 预处理一个 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 方法设定行并附加要新增的值。

静态否

参数

参数	类型	预设	描述
`$pairs`	阵列	必要	行和值的关联阵列

回传回传目前实例。

範例

// 预处理一个 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 方法回传 insert SQL 查询做为一个字串。

静态否

参数

参数	类型	预设	描述
`$db`	物件	必要	一个资料库连线

回传回传 SQL 查询做为一个字串。

範例

// 预处理一个 insert 语句
$query = DB::select('*')->from('users');

// 设定限制和偏移
$query->limit(10);
$query->offset(5);

// 取得资料库连线
$connection = Database_Connection::instance();

// 取得 SQL 查询
$sql = $query->compile($connection);

reset()

reset 方法重置目前实例的所有值。

静态	否
参数	无
回传	回传目前实例。
範例	// 预处理一个 insert 语句 $query = DB::insert('users'); // 设定一些值 $query->set(array( 'name' => 'John', 'surname' => 'Doe', )); // 重置它 $query->reset(); // 设定新的值 $query->table('admins')->set(array( 'name' => 'Mark', 'surname' => 'Handriks' )); // SQL 查询现在会是： // INSERT INTO `admins` (`name`, `surname`) VALUES ("Mark", "Hendriks")