新增

新增数据有多种方式。

添加一条数据

第一种是实例化模型对象后赋值并保存：

						$user           =
							new
							User; $user->name     =
							'thinkphp'; $user->email    =
							'[email protected]'; $user->save();
						
					

也可以使用data方法批量赋值：

						$user =
							new
							User; $user->data([
							'name'
							=>
							'thinkphp',
							'email'
							=>
							'[email protected]'
							]); $user->save();
						
					

或者直接在实例化的时候传入数据

						$user =
							new
							User([
							'name'
							=>
							'thinkphp',
							'email'
							=>
							'[email protected]'
							]); $user->save();
						
					

如果需要过滤非数据表字段的数据，可以使用：

						$user =
							new
							User($_POST);
							// 过滤post数组中的非数据表字段数据
							$user->allowField(true)->save();
						
					

如果你通过外部提交赋值给模型，并且希望指定某些字段写入，可以使用：

						$user =
							new
							User($_POST);
							// post数组中只有name和email字段会写入
							$user->allowField(['name','email'])->save();
						
					

save方法新增数据返回的是写入的记录数。

获取自增ID

如果要获取新增数据的自增ID，可以使用下面的方式：

						$user           =
							new
							User; $user->name     =
							'thinkphp'; $user->email    =
							'[email protected]'; $user->save();
							// 获取自增ID
							echo
							$user->id;
						
					

注意这里其实是获取模型的主键，如果你的主键不是id，而是user_id的话，其实获取自增ID就变成这样：

						$user           =
							new
							User; $user->name     =
							'thinkphp'; $user->email    =
							'[email protected]'; $user->save();
							// 获取自增ID
							echo
							$user->user_id;
						
					

注意不要在同一个实例里面多次新增数据，如果确实需要多次新增，那么可以用下面的方式：

						$user           = new User; $
								user->
							name
							=
							'thinkphp'; $
								user->email    =
							'[email protected]'; $
								user->save(); $
								user->
							name
							=
							'onethink'; $
								user->email    =
							'[email protected]';
							// 第二次开始必须使用下面的方式新增
							$
								user->
							
								isUpdate(false)->save();
						
					

添加多条数据

支持批量新增，可以使用：

						$user =
							new
							User; $list = [     ['name'=>'thinkphp','email'=>'[email protected]'],     ['name'=>'onethink','email'=>'[email protected]'] ]; $user->saveAll($list);
						
					

saveAll方法新增数据返回的是包含新增模型（带自增ID）的数据集（数组）。

V5.0.13+版本开始，saveAll方法的返回类型受模型的resultSetType属性影响（可能返回数据集对象）。

saveAll方法新增数据默认会自动识别数据是需要新增还是更新操作，当数据中存在主键的时候会认为是更新操作，如果你需要带主键数据批量新增，可以使用下面的方式：

						$user =
							new
							User; $list = [     ['id'=>1,
							'name'=>'thinkphp',
							'email'=>'[email protected]'],     ['id'=>2,
							'name'=>'onethink',
							'email'=>'[email protected]'], ]; $user->saveAll($list,
							false);
						
					

静态方法

还可以直接静态调用create方法创建并写入：

						$user = User::create([
							'name'
							=>
							'thinkphp',
							'email'
							=>
							'[email protected]'
							]);
							echo
							$user->name;
							echo
							$user->email;
							echo
							$user->id;
							// 获取自增ID
						
					

和save方法不同的是，create方法返回的是当前模型的对象实例。

助手函数

系统提供了model助手函数用于快速实例化模型，并且使用单例实现，例如：

						
							// 使用model助手函数实例化User模型
							$user = model('User');
							// 模型对象赋值
							$user->data([
							'name'
							=>
							'thinkphp',
							'email'
							=>
							'[email protected]'
							]); $user->save();
						
					

或者进行批量新增：

						$user = model('User');
							// 批量新增
							$list = [     ['name'=>'thinkphp','email'=>'[email protected]'],     ['name'=>'onethink','email'=>'[email protected]'] ]; $user->saveAll($list);