PHP Eloquent ORM框架 关于 Controller Dcat套件（表单数据选择器/匿名函數（闭包）/when与if差异/when解析/鏈式調用）

/**
     * 獲取用戶列表用於選擇器
     */
    public function users(Request $request)
    {
        $q = $request->get('q');
        
        $users = User::query()
            ->when($q, function ($query) use ($q) {
                $query->where('name', 'like', "%{$q}%")
                      ->orWhere('email', 'like', "%{$q}%");
            })
            ->limit(20)
            ->get(['id', 'name', 'email']);
        
        return $users->map(function ($user) {
            return [
                'id' => $user->id,
                'text' => $user->name . ' (' . $user->email . ')'
            ];
        });
    }

我们以该代码举例分析：
该代码块取自PHP的Laravel的Eloquent ORM中的一个表单选择器的Controller

---

1.表单数据选择器

结构流程：

声明公共方法，拿取Request $request 即前端数据

 public function users(Request $request)

变量q赋值到数据中的查询参数

  $q = $request->get('q');

ORM模型 sql查询到数据库中的对应参数的集合

 $users = User::query()
            ->when($q, function ($query) use ($q) {
                $query->where('name', 'like', "%{$q}%")
                      ->orWhere('email', 'like', "%{$q}%");
            })
            ->limit(20)
            ->get(['id', 'name', 'email']);

以前端所需要的固定map数组返回

return $users->map(function ($user) {
            return [
                'id' => $user->id,
                'text' => $user->name . ' (' . $user->email . ')'
            ];
        });

---

2.when与if的差异

->when($q, function ($query) use ($q) {
                $query->where('name', 'like', "%{$q}%")
                      ->orWhere('email', 'like', "%{$q}%");
            })

主要涉及代码为上

用if呈现

if ($q) {
    $query->where('name', 'like', "%{$q}%")
          ->orWhere('email', 'like', "%{$q}%");
}
$query->limit(20)->get(['id', 'name', 'email']);

差异点：
1：本身该段代码是属于查詢構造器的，在常规情况下使用when鏈式調用，而不必使用if

2：使用if阻断了链式调用（第三点详细提及）

3：如果$q有值的话，本质是与when无异，when本身就是对于if的封装

---

3：when解析

 ->when($q, function ($query) use ($q) {
                $query->where('name', 'like', "%{$q}%")
                      ->orWhere('email', 'like', "%{$q}%");
            })

when，可以接收2-3个参数：
 

• 第一個參數: 條件值$q

• 第二個參數: 當條件為真時執行的回調函數

• 第三個參數(可選): 當條件為假時執行的回調函數

代码示例内我们接受了2个参数
1：條件值$q，即我们在前端的筛选值
2：当条件值为有值的情况下，执行的闭包-》

($query) use ($q) {
                $query->where('name', 'like', "%{$q}%")
                      ->orWhere('email', 'like', "%{$q}%");
            }

---

4：鏈式調用

->when($q, function ($query) use ($q) {
                $query->where('name', 'like', "%{$q}%")
                      ->orWhere('email', 'like', "%{$q}%");
            })
            ->limit(20)
            ->get(['id', 'name', 'email']);

即我们可以->when/->limit/->get持续链式调用下去。

鏈式調用的優點

1. 代碼更緊湊 - 減少臨時變數更具可讀性 - 操作順序清晰可見
2. 流程更流暢 - 像自然語言般從左到右閱讀
3. 代碼更優雅 - 減少嵌套和條件語句干擾

---

对此已经大致了解了具体的运用和运用机制。
之后我们在次遇到需要PHP的 Eloquent ORM框架 Dcat套件或其他套件处理添加等表单中的下拉选择器（可填参数）
一些类似情况时可以进行逻辑复用并且熟悉差异点，能够进行进一步优化和处理。