应使用 $entity->isnew() 判断：返回 true 为 insert，false 为 update；因其内部检查 _new 属性及主键存在性，比 $this->id 更可靠，且避免手动设 id 或非自增主键导致的误判。
afterSave 里怎么知道是 insert 还是 update
CakePHP 的 afterSave 回调不自带操作类型参数，必须靠判断模型状态来区分。核心依据是：模型实例的 id 是否已存在，以及是否刚被赋值。
-
$this->id有值且非 null → 大概率是 update（但需排除手动设 id 后 save 的情况） -
$this->id为 null，且$this->isNew()返回 true → 明确是 insert - 更稳妥的方式是结合
beforeSave预存标记：$this->_isInsert = $this->isNew();，然后在afterSave中直接读取
为什么不能只看 $this->id 是否为空
因为 save() 允许显式传入带 id 的数据数组，比如 $article->save(['id' => 123, 'title' => 'xxx'])。此时即使 $this->id 有值，也可能是新记录（如用 REPLACE 或 ON DUPLICATE KEY UPDATE 场景），或主键非自增、由业务生成。
- 自增主键表中，
$this->isNew()是最可靠依据，它内部检查_new属性和主键是否已存在 - 如果模型启用了
$useAutoIncrement为 false，isNew()仍有效，但需确保构造时没传id - 避免用
!empty($this->id)判断，空字符串、0 等假值会导致误判
afterSave 中执行不同逻辑的典型写法
实际项目中常需对新增/更新做差异化处理，比如同步索引、发通知、更新统计字段。下面是最简明安全的模式：
public function afterSave(EventInterface $event, EntityInterface $entity, ArrayObject $options)
{
if ($entity->isNew()) {
// 新增逻辑：发欢迎邮件、初始化关联计数器、写入日志表
$this->Log->log('insert', $entity->get('id'));
} else {
// 更新逻辑：清除缓存、触发搜索索引更新、记录变更历史
Cache::delete('user_' . $entity->get('id'));
}
}
- 务必用
$entity->isNew()，不是$this->isNew()—— 回调中实体可能已被重新加载 - 不要在
afterSave里再调用save()，容易引发无限循环或事务嵌套问题 - 耗时操作（如 HTTP 请求、文件写入）建议投递到队列，否则会阻塞当前请求响应
容易被忽略的边界情况
真实业务中，这些点最容易出错：
- 批量更新（
updateAll()）根本不会触发afterSave—— 它绕过实体层，只走查询构造器 - 使用
patchEntity()+save()时，若原始实体来自find('all')，isNew()判定准确；但若来自newEntity()后又 set id，则需人工干预 - 软删除场景下，
delete()不触发afterSave，而是走afterDelete，别混用
EntityInterface $entity 的 isNew() 上，而不是模型实例或数据库字段值。其他所有技巧都是为兜住这个前提服务的。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
