save() 是 yii activerecord 新增数据最常用入口,但非直接写库,而是走校验→判断新旧记录→调用 insert() 的完整流程;值错误、规则未过、类型不匹配均会导致静默失败。

save() 是 Yii ActiveRecord 新增数据最常用的入口,但它不是“直接写库”,而是走校验 + 判断新旧记录 + 调用 insert() 的完整流程。值赋得不对、规则没过、类型不匹配,都会静默失败。
用 attributes 块赋值前先确认字段是安全属性
ActiveRecord 默认只允许对 rules() 里声明为“安全”的字段做批量赋值。比如:
public function rules()
{
return [
[['name', 'email'], 'required'],
['age', 'integer'], // age 是安全字段
['status', 'in', 'range' => [0, 1]], // status 也是
['avatar_url', 'string', 'max' => 255], // 也是
];
}
如果表里有个 created_at 字段没在 rules() 里声明,$model->attributes = $data 就不会给它赋值——哪怕 $data 里有这个键。
- 不加
safe规则的字段,只能单个赋值:$model->created_at = time(); - Gii 生成的模型常把
TINYINT字段默认设成'string'规则,你传1(int)会校验失败,必须传'1'或改规则为'integer' - 用
$model->load($post)时同理:只加载安全字段,且依赖表单字段名格式如User[username]
save() 失败时别只看返回值,要查 getErrors()
$model->save() 成功返回 true,失败返回 false,但不会抛异常——错误信息藏在 getErrors() 里:
if (!$model->save()) {
$errors = $model->getErrors();
// $errors 是二维数组,如 ['name' => ['Name cannot be blank.']]
var_dump($errors);
}
- 常见错误包括:必填字段为空、整型字段传了字符串、邮箱格式不对、唯一索引冲突
- 如果
getErrors()返回空数组,但save()还是失败,检查是否触发了beforeSave()返回false,或数据库层面限制(如 NOT NULL 但没设默认值) - 调试时可临时关闭验证:
$model->save(false),但上线前必须恢复
主键自增 ID 在保存后才能拿到,别在 save() 前读 id
新增时 $model->id 初始是 null 或 0,save() 成功后才被自动填充:
$model = new User();
$model->name = 'awen';
$model->age = 30;
if ($model->save()) {
echo $model->id; // ✅ 此时才有值,比如 123
// ❌ 不要在这里用 $model->attributes['id'],它可能还是 null
}
- 循环批量插入时,每次都要重置新记录状态:
$model->setIsNewRecord(true),否则第二次save()会走更新逻辑 - 如果模型主键不是自增(比如 UUID),需在
save()前手动赋值$model->id = \Yii::guid(); - 不要依赖
Yii::$app->db->getLastInsertID()获取当前模型 ID——它只反映上一条 INSERT 语句,多线程/事务下不可靠
最易忽略的一点:ActiveRecord 的 save() 行为完全取决于 isNewRecord 状态,而这个状态只在 new Model() 或显式调用 setIsNewRecord(true) 时为真;从 find() 拿到的对象,哪怕你清空所有字段,save() 仍会执行 UPDATE。新增逻辑必须确保对象是“新”的,而不是“看起来像新的”。











