3分鐘短文:無私分享!Laravel模型使用2個小技巧

ragus發表於2020-10-03

引言

上一節我們詳細講解了模型的訪問器功能,可以輕易擴充套件模型的屬性訪問,靈活又標準地增強了模型的讀取資料的能力。

img

本文我們接著往下講,說說模型的修改器,以及模型的職責。

修改器

有沒有這樣一種用法:使用表單獲取一個欄位的輸入,使用加密演算法,或者摘要方式對欄位處理後存入資料庫,

這在資料庫密碼欄位是常用的處理手段。

如果寫操作在程式內到處都是,零散地分佈在業務程式碼的各個地方,我們總不至於每次都要寫一次相同的程式碼吧?

相同的業務邏輯,提取出來,抽象出來,只寫一次,這才是高效程式碼的王道。

laravel這個注重設計模式的現代化框架,自然是不會做無用功。於是對應讀取器,就有了修改器,專門用於寫入資料庫時起作用。

比如對於寫操作,某個欄位的值寫入,預設使用 bcrypt 方法加密之後存入資料庫。

class User extends Model {
    public function setPasswordAttribute($password)
    {
        $this->attributes['password'] = bcrypt($password);
    }
}

上述方法呼叫模型的 $attributes 屬性,並使用自定義方法改寫,在使用 ->password 屬性進行賦值後,就會呼叫該方法的程式碼並執行。

我們仍然在 tinker 內進行演示:

$user = new User;
$user->password = 'blah';
echo $user->password;
// 輸出 $2y$10$e3ufaNvBFWM/SeFc4ZyAhe8u5UR/K0ZUc5IjCPUvOYv6IVuk7Be7q

自定義方法

框架獨立出來模型這個資料庫操作層的目的,就是為了把資料操作全部集中到模型內完成,以便可以全域性統一,規範地編寫程式碼。

下面舉個例子,說明一下哪些邏輯應該放在模型層操作。比如有一個檢視檔案內的一個展示片段:

@if ($event->started_at->isToday())
    This event is occurring today!
@endif

其中 $event 是模型 Event 物件的一個例項,start_at 方法是模型的一個屬性,也是資料庫表的一個欄位。按照之前章節的介紹,我們對其使用了訪問器的方法,自動在讀取的時候使用 Carbon 類返回一個例項化物件。所以上面的程式碼片段可以使用 isToday() 這個 Carbon 類的方法。

但是在模型層面進行類庫方法的呼叫,有些單獨,且零散。假如有些API介面要使用此方法格式化,或者別的頁面也要重用這個方法,顯然放在模型內更為合適。

考慮在模型內新增以下程式碼:

class Event extends Model {
    public function occurringToday()
    {
        return $this->started_at->isToday();
    }
}

宣告一個public的公開訪問的私有化方法,並操作物件的例項 $this的屬性和方法。

那麼上述的blade模板內的程式碼就可以更換如下:

@if ($event->occurringToday())
    This event is occurring today!
@endif

這樣邏輯摘出來就清楚的多了。而且可維護性更強。為什麼?因為假如後期我們業務出現變動,不再使用 start_at 欄位進行判斷,可以很容易地通過修改 occurringToday 方法而達成全域性生效的目的。

這樣的程式就很靈活了。

寫在最後

本文描述了laravel模型內很常用的兩個小技巧。

  • 一個是修改器,讓你不必每次在寫入資料的時候,考慮如何轉換,如何判斷,不再寫重複的囉嗦的程式碼;

  • 一個是如何優化檢視檔案,以及如何權衡設計技巧,讓模型做模型應該做的事情,儘量在程式碼內把職責劃分清楚。

規範的設計,能讓一個專案的程式碼更為健壯。

Happy coding :-)

我是@程式設計師小助手,專注程式設計知識,圈子動態的IT領域原創作者

本作品採用《CC 協議》,轉載必須註明作者和本文連結
write-less-do-more-make-you-out-of-door

相關文章