摘要：看起來是一個簡單的機制，但是在底層，有很多半隱藏的函數(shù)和鮮為人知的方式來實現(xiàn)更多功能。在這篇文章中，我將演示幾個小技巧。另外，在里也有些和時間相關(guān)的預(yù)定義方法通過關(guān)系排序一個復(fù)雜一點的技巧。幸運的是，確實有這樣的方法。

Eloquent ORM 看起來是一個簡單的機制，但是在底層，有很多半隱藏的函數(shù)和鮮為人知的方式來實現(xiàn)更多功能。在這篇文章中，我將演示幾個小技巧。

要代替以下實現(xiàn)：

$article = Article::find($article_id);
$article->read_count++;
$article->save();

你可以這樣做：

$article = Article::find($article_id);
$article->increment("read_count");

以下這些方法也可以實現(xiàn)：

Article::find($article_id)->increment("read_count");
Article::find($article_id)->increment("read_count", 10); // +10
Product::find($produce_id)->decrement("stock"); // -1

*

Eloquent 有相當一部分函數(shù)可以把兩個方法結(jié)合在一起使用, 例如 『 請先執(zhí)行 X 方法， X 方法執(zhí)行不成功則執(zhí)行 Y 方法 』。

實例 1?--?findOrFail():

要替代以下代碼的實現(xiàn)：

$user = User::find($id);
if (!$user) { abort (404); }

你可以這樣寫：

$user = User::findOrFail($id);

實例 2?--?firstOrCreate():

要替代以下代碼的實現(xiàn)：

$user = User::where("email", $email)->first();
if (!$user) {
  User::create([
    "email" => $email
  ]);
}

這樣寫就可以了：

$user = User::firstOrCreate(["email" => $email]);

*

在一個 Eloquent 模型中，有個神奇的地方，叫?boot()，在那里，你可以覆蓋默認的行為：

class User extends Model
{
    public static function boot()
    {
        parent::boot();
        static::updating(function($model)
        {
            // 寫點日志啥的
            // 覆蓋一些屬性，類似這樣 $model->something = transform($something);
        });
    }
}

在創(chuàng)建模型對象時設(shè)置某些字段的值，大概是最受歡迎的例子之一了。 一起來看看在創(chuàng)建模型對象時，你想要生成?UUID 字段?該怎么做。

public static function boot()
{
  parent::boot();
  self::creating(function ($model) {
    $model->uuid = (string)Uuid::generate();
  });
}

*

定義關(guān)聯(lián)關(guān)系的一般方式：

public function users() {
    return $this->hasMany("AppUser");
}

你知道嗎？也可以在上面的基礎(chǔ)上增加?where?或者?orderBy?
舉個例子，如果你想關(guān)聯(lián)某些類型的用戶，同時使用 email 字段排序，你可以這樣做：

public function approvedUsers() {
    return $this->hasMany("AppUser")->where("approved", 1)->orderBy("email");
}

*

Eloquent模型有些參數(shù)，使用類的屬性形式。最常用是：

class User extends Model {
    protected $table = "users";
    protected $fillable = ["email", "password"]; // 可以被批量賦值字段，如 User::create() 新增時，可使用字段
    protected $dates = ["created_at", "deleted_at"]; // 需要被Carbon維護的字段名
    protected $appends = ["field1", "field2"]; // json返回時，附加的字段
}

不只這些，還有：

protected $primaryKey = "uuid"; // 更換主鍵
public $incrementing = false; // 設(shè)置 不自增長
protected $perPage = 25; // 定義分頁每頁顯示數(shù)量（默認15）
const CREATED_AT = "created_at";
const UPDATED_AT = "updated_at"; //重寫 時間字段名
public $timestamps = false; // 設(shè)置不需要維護時間字段

還有更多,我只列出了一些有意思的特性，具體參考文檔?abstract Model class?了解所有特性.

*

所有人都知道 find() 方法，對吧？

$user = User::find(1);

我十分意外竟然很少人知道這個方法可以接受多個 ID 的數(shù)組作為參數(shù)：

$users = User::find([1,2,3]);

*

有一種優(yōu)雅的方式能將這種代碼：

$users = User::where("approved", 1)->get();

轉(zhuǎn)換成這種：

$users = User::whereApproved(1)->get();

對，你沒有看錯，使用字段名作為后綴添加到 where 后面，它就能通過魔術(shù)方法運行了。

另外，在 Eloquent 里也有些和時間相關(guān)的預(yù)定義方法：

User::whereDate("created_at", date("Y-m-d"));
User::whereDay("created_at", date("d"));
User::whereMonth("created_at", date("m"));
User::whereYear("created_at", date("Y"));

*

一個復(fù)雜一點的「技巧」。你想對論壇話題按最新發(fā)布的帖子來排序？論壇中最新更新的主題在最前面是很常見的需求，對吧？

首先，為主題的最新帖子定義一個多帶帶的關(guān)系：

public function latestPost()
{
    return $this->hasOne(AppPost::class)->latest();
}

然后，在控制器中，我們可以實現(xiàn)這個「魔法」：

$users = Topic::with("latestPost")->get()->sortByDesc("latestPost.created_at");

*

很多人都喜歡使用"if-else"來寫查詢條件，像這樣：

if (request("filter_by") == "likes") {
    $query->where("likes", ">", request("likes_amount", 0));
}
if (request("filter_by") == "date") {
    $query->orderBy("created_at", request("ordering_rule", "desc"));
}

有一種更好的方法 -- 使用 when()

$query = Author::query();
$query->when(request("filter_by") == "likes", function ($q) {
    return $q->where("likes", ">", request("likes_amount", 0));
});
$query->when(request("filter_by") == "date", function ($q) {
    return $q->orderBy("created_at", request("ordering_rule", "desc"));
});

它可能看上去不是很優(yōu)雅，但它強大的功能是傳遞參數(shù)：

$query = User::query();
$query->when(request("role", false), function ($q, $role) {
    return $q->where("role_id", $role);
});
$authors = $query->get();

*

假設(shè)現(xiàn)在有種情況是要顯示文章的作者，然后模板代碼是：

{{ $post->author->name }}

但是如果作者的信息被刪除或者因為某些原因沒有被設(shè)置。代碼會返回一個錯誤，諸如 "property of non-object"。

當然你可以這樣處理：

{{ $post->author->name ?? "" }}

你可以通過 Eloquent 關(guān)系這樣做:

public function author()
{
    return $this->belongsTo("AppAuthor")->withDefault();
}

在此示例中，如果文字沒有作者的信息，?author()?會返回一個空的?AppAuthor 模型對象。

再者，我們也可以給默認的模型對象里面的屬性賦默認值。

public function author()
{
    return $this->belongsTo("AppAuthor")->withDefault([
        "name" => "Guest Author"
    ]);
}

*

想象一下你有這樣的代碼:

function getFullNameAttribute()
{
  return $this->attributes["first_name"] . " " . $this->attributes["last_name"];
}

現(xiàn)在,你想要通過 "full_name" 進行排序? 發(fā)現(xiàn)是沒有效果的:

$clients = Client::orderBy("full_name")->get(); //沒有效果

解決辦法很簡單.我們需要在獲取結(jié)果后對結(jié)果進行排序.

$clients = Client::get()->sortBy("full_name"); // 成功!

注意的是方法名稱是不相同的 -- 它不是orderBy,而是sortBy

*

如果你想要?User::all()?總是按照?name?字段來排序呢？ 你可以給它分配一個全局作用域。讓我們回到?boot()?這個我們在上文提到過的方法：

protected static function boot()
{
    parent::boot();

    // 按照 name 正序排序
    static::addGlobalScope("order", function (Builder $builder) {
        $builder->orderBy("name", "asc");
    });
}

擴展閱讀?查詢作用域 。

*

有時候，我們需要在 Eloquent 語句中添加原生查詢。 幸運的是，確實有這樣的方法。

// whereRaw
$orders = DB::table("orders")
    ->whereRaw("price > IF(state = "TX", ?, 100)", [200])
    ->get();

// havingRaw
Product::groupBy("category_id")->havingRaw("COUNT(*) > 1")->get();

// orderByRaw
User::where("created_at", ">", "2016-01-01")
  ->orderByRaw("(updated_at - created_at) desc")
  ->get();

*

很簡單。說明不是很深入，下面是復(fù)制數(shù)據(jù)庫實體（一條數(shù)據(jù)）的最佳方法：

$task = Tasks::find(1);
$newTask = $task->replicate();
$newTask->save();

*

與 Eloquent 不完全相關(guān),它更多的關(guān)于 Collection (集合),但是對于處理大數(shù)據(jù)集合,仍然是很有用的。你可以使用 chunk() 將這些數(shù)據(jù)分割成小數(shù)據(jù)塊

修改前:

$users = User::all();
foreach ($users as $user) {
    // ...

你可以這樣做:

User::chunk(100, function ($users) {
    foreach ($users as $user) {
        // ...
    }
});

*

我們都知道Artisan命令：

php artisan make:model Company

但是，你知道有三個有用的標記可以為模型生成相關(guān)文件嗎？

php artisan make:model Company -mcr

-m 將創(chuàng)建一個遷移文件

-c 將創(chuàng)建一個控制器

-r 表示控制器應(yīng)該是一個資源控制器

*

你知道? ->save() 方法可以接受參數(shù)嗎? 我們可以通過傳入?yún)?shù)阻止它的默認行為：更新 updated_at 的值為當前時間戳。

$product = Product::find($id);
$product->updated_at = "2019-01-01 10:00:00";
$product->save(["timestamps" => false]);

這樣，我們成功在 save 時指定了 updated_at 的值。

*

你是否想知道這段代碼實際上返回什么？

$result = $products->whereNull("category_id")->update(["category_id" => 2]);

我是說，更新操作是在數(shù)據(jù)庫中執(zhí)行的，但 $result 會包含什么？

答案是受影響的行。 因此如果你想檢查多少行受影響， 你不需要額外調(diào)用其他任何內(nèi)容 --?update()?方法會給你返回此數(shù)字。

*

如果你有個 and 和 or 混合的 SQL 查詢，像這樣子的：

... WHERE (gender = "Male" and age >= 18) or (gender = "Female" and age >= 65)

怎么用 Eloquent 來翻譯它呢？ 下面是一種錯誤的方式：

$q->where("gender", "Male");
$q->orWhere("age", ">=", 18);
$q->where("gender", "Female");
$q->orWhere("age", ">=", 65);

順序就沒對。正確的打開方式稍微復(fù)雜點，使用閉包作為子查詢：

$q->where(function ($query) {
    $query->where("gender", "Male")
        ->where("age", ">=", 18);
})->orWhere(function($query) {
    $query->where("gender", "Female")
        ->where("age", ">=", 65);
})

*

終于，你可以傳遞陣列參數(shù)給 orWhere()。平常的方式：

$q->where("a", 1);
$q->orWhere("b", 2);
$q->orWhere("c", 3);

你可以這樣做：

$q->where("a", 1);
$q->orWhere(["b" => 2, "c" => 3]);

*

我很確定還有更多隱藏的秘訣，但我希望至少上面的其中一些對你來說是新的。

更多現(xiàn)代化 PHP 知識，請前往 Laravel / PHP 知識社區(qū)