表对象¶

afterMarshal¶

Cake\ORM\Table::afterMarshal(EventInterface $event, EntityInterface $entity, ArrayObject $data, ArrayObject $options)¶

Model.afterMarshal 事件在请求数据被转换为实体后触发。 事件处理程序将获得转换后的实体、原始请求数据以及提供给 patchEntity() 或 newEntity() 调用的选项。

beforeFind¶

Cake\ORM\Table::beforeFind(EventInterface $event, SelectQuery $query, ArrayObject $options, boolean $primary)¶

在每次查找操作之前，都会触发Model.beforeFind 事件。通过停止事件并为查询提供自定义结果集，您可以完全绕过查找操作。

public function beforeFind(EventInterface $event, SelectQuery $query, ArrayObject $options, $primary)
{
    if (/* ... */) {
        $event->stopPropagation();
        $query->setResult(new \Cake\Datasource\ResultSetDecorator([]));

        return;
    }
    // ...
}

在这个例子中，不会在相关表或其附加的行为上触发任何进一步的beforeFind 事件（尽管行为事件通常会在其默认优先级之前被调用），并且查询将返回通过SelectQuery::setResult() 传递的空结果集。

对$query 实例进行的任何更改都将保留在查找的剩余时间内。 $primary 参数指示这是否是根查询，还是关联查询。所有参与查询的关联都会触发一个Model.beforeFind 事件。对于使用联接的关联，将提供一个虚拟查询。在您的事件监听器中，您可以设置额外的字段、条件、联接或结果格式化程序。这些选项/功能将复制到根查询中。

在早期版本的 CakePHP 中，有一个afterFind 回调，现在已被使用 Map/Reduce 修改结果 功能和实体构造函数取代。

buildValidator¶

Cake\ORM\Table::buildValidator(EventInterface $event, Validator $validator, $name)¶

当创建$name 验证器时，会触发Model.buildValidator 事件。行为可以使用此钩子添加验证方法。

buildRules¶

Cake\ORM\Table::buildRules(EventInterface $event, RulesChecker $rules)¶

在创建规则实例后，以及在调用表的buildRules() 方法后，会触发Model.buildRules 事件。

beforeRules¶

Cake\ORM\Table::beforeRules(EventInterface $event, EntityInterface $entity, ArrayObject $options, $operation)¶

在对实体应用规则之前，会触发Model.beforeRules 事件。通过停止此事件，您可以停止规则检查并设置应用规则的结果。

afterRules¶

Cake\ORM\Table::afterRules(EventInterface $event, EntityInterface $entity, ArrayObject $options, $result, $operation)¶

在对实体应用规则之后，会触发Model.afterRules 事件。通过停止此事件，您可以返回规则检查操作的最终值。

beforeSave¶

Cake\ORM\Table::beforeSave(EventInterface $event, EntityInterface $entity, ArrayObject $options)¶

在保存每个实体之前，都会触发Model.beforeSave 事件。停止此事件将中止保存操作。当事件停止时，将返回事件的结果。

afterSave¶

Cake\ORM\Table::afterSave(EventInterface $event, EntityInterface $entity, ArrayObject $options)¶

在保存实体后，会触发Model.afterSave 事件。

afterSaveCommit¶

Cake\ORM\Table::afterSaveCommit(EventInterface $event, EntityInterface $entity, ArrayObject $options)¶

在保存操作所包装的交易提交后，会触发Model.afterSaveCommit 事件。它也会在非原子保存的情况下触发，其中数据库操作隐式提交。此事件仅对直接调用save() 的主表触发。如果在调用 save 之前启动了事务，则不会触发该事件。

beforeDelete¶

Cake\ORM\Table::beforeDelete(EventInterface $event, EntityInterface $entity, ArrayObject $options)¶

在删除实体之前，会触发Model.beforeDelete 事件。通过停止此事件，您将中止删除操作。当事件停止时，将返回事件的结果。

afterDelete¶

Cake\ORM\Table::afterDelete(EventInterface $event, EntityInterface $entity, ArrayObject $options)¶

在删除实体后，会触发Model.afterDelete 事件。

afterDeleteCommit¶

Cake\ORM\Table::afterDeleteCommit(EventInterface $event, EntityInterface $entity, ArrayObject $options)¶

在删除操作所包装的交易提交后，会触发Model.afterDeleteCommit 事件。它也会在非原子删除的情况下触发，其中数据库操作隐式提交。此事件仅对直接调用delete() 的主表触发。如果在调用 delete 之前启动了事务，则不会触发该事件。

停止表事件¶

要阻止保存继续，只需在您的回调中停止事件传播

public function beforeSave(EventInterface $event, EntityInterface $entity, ArrayObject $options)
{
    if (...) {
        $event->stopPropagation();
        $event->setResult(false);

        return;
    }
    ...
}

或者，您可以从回调中返回 false。这与停止事件传播的效果相同。

回调优先级¶

在表和行为上使用事件时，请注意优先级和附加监听器的顺序。行为事件是在表事件之前附加的。使用默认优先级意味着行为回调将在具有相同名称的表事件**之前**触发。

例如，如果您的表使用TreeBehavior，TreeBehavior::beforeDelete() 方法将在您的表的beforeDelete() 方法之前调用，并且您将无法在表的该方法中使用要删除的记录的子节点。

您可以通过以下几种方式管理事件优先级

1. 使用priority 选项更改行为的监听器的priority。这将修改行为中**所有**回调方法的优先级

   // In a Table initialize() method
   $this->addBehavior('Tree', [
       // Default value is 10 and listeners are dispatched from the
       // lowest to highest priority.
       'priority' => 2,
   ]);
   

2. 通过使用Model.implementedEvents() 方法，在您的Table 类中修改priority。这允许您为每个回调函数分配不同的优先级

   // In a Table class.
   public function implementedEvents()
   {
       $events = parent::implementedEvents();
       $events['Model.beforeDelete'] = [
           'callable' => 'beforeDelete',
           'priority' => 3
       ];
   
       return $events;
   }