TP5 模型新增的返回值、返回值的判断以及所使用的SQL

TP5 模型新增主要使用静态方法 create 和动态方法 save 

静态方法 create 

直接使用模型类静态调用，例如 Test 模型类新增 username 为 a 的用户，如下

$data = ['username' => 'a'];
 
$result = TestModel::create($data);

生成的 SQL 如下

 INSERT INTO `test` (`username`) VALUES ('a') 

返回值

执行 create 方法成功则返回当前新增数据的模型类实例，失败则报错

重要提醒

执行 create 方法成功不代表新增数据成功，如果当前新增数据的字段名在数据库内是不存在的， create 方法是不会向数据库发送 SQL 语句的，如下

$test = new TestModel();
 
$data = ['name' => 'a'];
 
$result = TestModel::create($data);

因为模型在执行新增操作前，会发送一条 SQL 语句获得表结构，如下

SHOW COLUMNS FROM `test`

因为 name 字段在表结构中是不存在的，所以 create 方法是不会向数据库发送 SQL 语句的，而且 create 方法不会有任何错误提示，依然能返回新增数据的模型类实例，如下

object(app\index\model\Test)#43 (2) {
  ["data"]=>
  array(1) {
    ["name"]=>
    string(1) "a"
  }
  ["relation"]=>
  array(0) {
  }
}

动态方法 save

使用模型类实例动态调用，例如 Test 模型类实例新增 username 为 a 的用户，如下

$obj = new TestModel();
 
$data = ['username' => 'a'];
    
$result = $obj->save($data);

生成的 SQL 如下

INSERT INTO `test` (`username`) VALUES ('a') 

返回值

V5.1.6+版本以前

save 方法返回新增的记录数

V5.1.6+版本以后

统一返回布尔值，如果执行 save 方法成功则返回 true（哪怕新增的行数是 0 也是返回 true ），并只有当 before_update 事件返回 false 的时候返回 false

重要提醒

1、从 V5.1.6+版本开始，save 方法只管执行 SQL 不管 SQL 执行后的结果，执行 SQL 成功则返回 true（哪怕新增的行数是 0 也是返回 true ）

2、和静态方法 create 一样，执行 save 方法成功不代表新增数据成功，如果当前新增数据的字段名在数据库内是不存在的， save 方法是不会向数据库发送 SQL 语句的，如下

$data = ['name' => 'a']; // name 字段在表结构中是不存在的
 
$obj = new TestModel();
 
$result = $obj->save($data);

因为模型在执行新增操作前，会发送一条 SQL 语句获得表结构，如下

SHOW COLUMNS FROM `test`

因为 name 字段在表结构中是不存在的，所以 save 方法是不会向数据库发送 SQL 语句的，而且 save 方法不会有任何错误提示，依然能返回 true，如下

bool(true)

更重要提醒

save 方法会修改调用它的对象的数据

$user = new TestModel();
 
echo ("
");
var_dump($user);
echo ("

");