# 事件操作 ### [](https://octobercms.com/docs/database/model#events)Events 模型會引發多個事件，使您可以陷入模型生命周期的各個階段。通過事件，您可以在每次在數據庫中保存或更新特定模型類時輕松地執行代碼。通過覆蓋類中的特殊方法來定義事件，可以使用以下方法覆蓋： | 事件 | 描述 | | --- | --- | | **beforeCreate** | 在模型保存之前（首次創建時）。 | | **afterCreate** | 保存模型后，首次創建時。 | | **beforeSave** | 在保存模型（創建或更新）之前。 | | **afterSave** | 保存模型后，創建或更新模型。 | | **beforeValidate** | 在驗證提供的模型數據之前。 | | **afterValidate** | 在驗證提供的模型數據之后。 | | **beforeUpdate** | 保存現有模型之前。 | | **afterUpdate** | 保存現有模型后。 | | **beforeDelete** | 在刪除現有模型之前。 | | **afterDelete** | 刪除現有模型后。 | | **beforeRestore** | 在恢復軟刪除的模型之前。 | | **afterRestore** | 恢復軟刪除的模型后。 | | **beforeFetch** | 在填充現有模型之前。 | | **afterFetch** | 在填充現有模型之后。 | 使用事件的示例： ~~~ /** * Generate a URL slug for this model */ public function beforeCreate() { $this->slug = Str::slug($this->name); } ~~~ > **注意：**如果尚未提交使用[延遲綁定](https://octobercms.com/docs/database/relations#deferred-binding)創建的關系（即文件附件），則在`afterSave`模型事件中將不可用它們。要訪問未提交的綁定，請`withDeferred($sessionKey)`在關系上使用方法。例：`$this->images()->withDeferred(post('_session_key'))->get();` ### [](https://octobercms.com/docs/database/model#basic-usage)基本用法 每當首次保存新模型時，`beforeCreate`和`afterCreate`事件就會觸發。如果數據庫中已經存在模型并且`save`調用了該方法，則`beforeUpdate`/`afterUpdate`事件將觸發。但是，在兩種情況下，`beforeSave`/`afterSave`事件都會觸發。 例如，讓我們定義一個事件偵聽器，該事件偵聽器在首次創建模型時填充slug屬性： ~~~ /** * Generate a URL slug for this model */ public function beforeCreate() { $this->slug = Str::slug($this->name); } ~~~ `false`從事件返回將取消`save`/`update`操作： ~~~ public function beforeCreate() { if (!$user->isValid()) { return false; } } ~~~ 可以使用`original`屬性訪問舊值。例如： ~~~ public function afterUpdate() { if ($this->title != $this->original['title']) { // title changed } } ~~~ 您可以使用方法在外部綁定到模型的單個實例的[本地事件](https://octobercms.com/docs/services/events)`bindEvent`。事件名稱應與方法覆蓋名稱相同，并以開頭`model.`。 ~~~ $flight = new Flight; $flight->bindEvent('model.beforeCreate', function() use ($model) { $model->slug = Str::slug($model->name); }) ~~~