摘要:我們設置好模型的觸發時機,當模型觸發事件,監聽器就會被調。雖然,我能通過模型觀察器快速實現,但是,我想引導你為單個事件觸發配置事件監聽器。現在,當模型調用事件時,我們注冊的事件監聽器也會被觸發并執行。
Laravel 模型事件允許你監聽模型生命周期內的多個關鍵點,甚至可以在阻止一個模型的保存或者刪除。 Laravel 模型事件文檔 概述了如何使用鉤子將對應事件與相關的事件類型關聯起來,但是本文的主旨是事件與監聽器的構建與設置,并額外補充一些細節的說明。
事件概述Eloquent 有很多事件可以讓你使用鉤子將它們關聯起來,并且增加自定義的功能到你的模型中。該模型起始時有以下事件:
retrieved
creating
created
updating
updated
saving
saved
deleting
deleted
restoring
restored
從文檔這里我們可以了解它們都是如何實現的,你還可以進入 Model 的基類去看看它們到底是如何實現的:
當現有模型被數據庫檢索時, retrieved 事件將會觸發。當一個新的模型被第一次保存時, ?creating?和?created?事件將會觸發。如果對一個已經存在于數據庫的模型調用?save 方法,?updating?/?updated?事件將會觸發。無論怎樣,在這兩種情況下,?saving?/?saved?事件都會觸發。
文檔中對模型事件進行了很好的概述,同時解釋了怎樣使用鉤子去關聯事件,但是如果你是初學者,或者并不是熟悉怎樣使用鉤子將事件監聽器與這些自定義模型事件相關聯,請進一步閱讀本文。
注冊 事件為了在你的模型中關聯一個事件,你需要做的第一件事是使用?$dispatchesEvents?屬性去注冊事件對象,這最終將通過 ?HasEvents::fireCustomModelEvent()?方法觸發, 該方法將通過 ?fireModelEvent()?方法被調用。?fireCustomModelEvent() 方法原始的時候大致是下面這樣:
/** * 為給定的事件觸發一個自定義模型。 * * @param string $event * @param string $method * @return mixed|null */ protected function fireCustomModelEvent($event, $method) { if (! isset($this->dispatchesEvents[$event])) { return; } $result = static::$dispatcher->$method(new $this->dispatchesEvents[$event]($this)); if (! is_null($result)) { return $result; } }
一些事件,比如?delete, 將進行檢測判斷是否這個事件會返回 false?然后退出操作。比如,你可以使用這個鉤子去做一些檢測,也可以防止一個用戶被創建或刪除。
使用 ?AppUser?模型舉例, 這里展示了如何配置你的模型事件:
protected $dispatchesEvents = [ "saving" => AppEventsUserSaving::class, ];
你可以使用?artisan make:event?命令來為你創建這個事件, 但基本上這將是你最后得到結果 :
user = $user; } }
我們的事件提供了一個公有的?$user?屬性以便你能夠在 saving事件期間訪問 User模型實例。
為了讓它工作起來下一步需要做的是為這個事件建立一個實際的監聽器。我們設置好模型的觸發時機,當?User模型觸發?saving?事件,監聽器就會被調。
創建一個事件監聽器現在,我們定義 User 模型并注冊一個事件監聽器來監聽?saving 事件的觸發。雖然,我能通過模型觀察器快速實現,但是,我想引導你為單個事件觸發配置事件監聽器。
事件監聽器就像 Laravel 其它事件監聽一樣,handle() 方法將接收 AppEventsUserSaving 事件類的一個實例。
你可以手動創建它,也可以使用 php artisan make:listener 命令。 不管怎么樣,你都將創建一個像下面這樣子監聽類:
info($event->user); } }
我只是添加了一個日志記錄調用,以便于檢查傳遞給監聽器的模型。為此,我們還需要在 EventServiceProvider::$listen 屬性中注冊監聽器:
[ AppListenersUserSaving::class, ], ]; // ... }
現在,當模型調用 saving 事件時,我們注冊的事件監聽器也會被觸發并執行。
嘗試事件監聽我們可以通過 tinker?會話快速生成事件監聽代碼:
php artisan tinker >>> factory(AppUser::class)->create(); => AppUser {#794 name: "Aiden Cremin", email: "josie05@example.com", updated_at: "2018-03-15 03:57:18", created_at: "2018-03-15 03:57:18", id: 2, }
如果你已正確注冊了事件和監聽器,則應該在 ?laravel.log 文件中可以看到該模型的 JSON 表達形式:
[2018-03-15 03:57:18] local.INFO: {"name":"Aiden Cremin","email":"josie05@example.com"}
要注意的一點,此時模型并沒有 created_at?或?updated_at 屬性。如果在模型上再次調用 save() ,日志上將會有一個帶有時間戳的新記錄,因為 saving 事件會在新創建的記錄或現在有記錄上觸發:
>>> $u = factory(AppUser::class)->create(); => AppUser {#741 name: "Eloisa Hirthe", email: "gottlieb.itzel@example.com", updated_at: "2018-03-15 03:59:37", created_at: "2018-03-15 03:59:37", id: 3, } >>> $u->save(); => true >>>停止一個保存操作
某些模型事件是允許你進行阻止操作的。舉個荒謬的例子,假設我們不允許任何一個用戶的模型保存其屬性 $user->name? 的內容為 Paul :
/** * 處理事件。 * * @param AppEventsUserSaving $event * @return mixed */ public function handle(UserSaving $event) { if (stripos($event->user->name, "paul") !== false) { return false; } }
在 Eloquent 的 Model::save() 方法中,會根據事件監聽的返回結果判斷是否進行停止保存操作:
public function save(array $options = []) { $query = $this->newQueryWithoutScopes(); // 如果 "saving" 事件返回 false ,我們將退出保存并返回 // false,表示保存失敗。這為服務監聽者提供了一個機會, // 當驗證失敗或者出現其它任何情況,都可以取消保存操作。 if ($this->fireModelEvent("saving") === false) { return false; }
這個 ?save()? 是個很好的例子,它告訴了你如何在模型生命周期中自定義事件,以及被動執行日志數據記錄或者任務調度。
使用觀察者如果你正在監聽多個事件,那么你可能會發現使用觀察者類來按類型分組存放事件會更加方便。這里是一個例子? Eloquent 觀察者 :
你可以在服務提供者 AppServiceProvider 中的 boot() 方法里注冊觀察者。
/** * 運行所有應用服務。 * * @return void */ public function boot() { User::observe(UserObserver::class); }了解更多我建議你閱讀? Laravel 事件文檔?去了解有關事件和監聽器在整個框架中如何工作。 Eloquent 事件文檔 ? 對于可用事件以及如何使用觀察者是一個非常好的參考。最后,我建議瀏覽 IlluminateDatabaseEloquentModel?類來查找?fireModelEvent()?方法調用的用法去了解事件如何與模型和?HasEvents?trait 將這些事件聯系在一起。
現代化 PHP 知識日新月異,尤其是 PHP7 出來以后,歡迎加入 PHP / Laravel 知識社區 一起成長。
文章版權歸作者所有,未經允許請勿轉載,若此文章存在違規行為,您可以聯系管理員刪除。
轉載請注明本文地址:http://specialneedsforspecialkids.com/yun/28479.html
摘要:說明本文主要講述使用作為緩存加快頁面訪問速度。何不用來做緩存,等到該達到一定瀏覽頁面后再刷新下,效率也很高。可作緩存系統隊列系統。 說明:本文主要講述使用Redis作為緩存加快頁面訪問速度。同時,作者會將開發過程中的一些截圖和代碼黏上去,提高閱讀效率。 備注:作者最近在學習github上別人的源碼時,發現好多在計算一篇博客頁面訪問量view_count時都是這么做的:利用Laravel...
摘要:原文發表在我的個人網站系列入門教程二最適合中國人的教程本教程示例代碼見大家在任何地方卡住,最快捷的解決方式就是去看我的示例代碼。 原文發表在我的個人網站:Laravel 5 系列入門教程(二)【最適合中國人的 Laravel 教程】 本教程示例代碼見:https://github.com/johnlui/Learn-Laravel-5 大家在任何地方卡住,最快捷...
摘要:過去一年時間寫了多篇文章來探討了我認為的框架最核心部分的設計思路代碼實現。為了大家閱讀方便,我把這些源碼學習的文章匯總到這里。數據庫算法和數據結構這些都是編程的內功,只有內功深厚了才能解決遇到的復雜問題。 過去一年時間寫了20多篇文章來探討了我認為的Larave框架最核心部分的設計思路、代碼實現。通過更新文章自己在軟件設計、文字表達方面都有所提高,在剛開始決定寫Laravel源碼分析地...
閱讀 3274·2021-11-23 09:51
閱讀 939·2021-09-03 10:30
閱讀 3212·2021-08-31 09:40
閱讀 3278·2019-08-30 14:22
閱讀 902·2019-08-30 14:09
閱讀 2900·2019-08-30 13:21
閱讀 3232·2019-08-28 18:03
閱讀 2859·2019-08-26 13:44