Laravel 以其優雅和易用性而聞名，它真正閃耀的領域之一是資料庫查詢。通常，您會發現自己需要根據使用者輸入或其他動態因素來建立複雜的查詢。 Laravel 的 Eloquent ORM 提供了一種乾淨簡單的方式與資料庫交互，但是如果您想讓模型查詢更加靈活怎麼辦？輸入模型過濾的概念。

在本部落格中，我們將探索如何在 Laravel 中創建可重複使用且功能強大的模型過濾器。這將允許您根據傳入的請求參數動態套用查詢條件，使您的 Eloquent 查詢更加模組化和可維護。

為什麼要使用模型過濾器？

Laravel 中的模型過濾器是一個類，它封裝了根據使用者輸入建立動態查詢條件所需的所有邏輯。這有助於保持控制器清潔、重複使用程式碼並使您的應用程式更加模組化。

使用模型過濾器的優點：

• 關注點分離：透過將查詢邏輯移至專用類別來保持控制器乾淨。

• 可重複使用性：讓您在多個控制器或查詢中重複使用相同的篩選器邏輯。

• 靈活性：可以更輕鬆地新增或修改查詢條件，而無需更改應用程式的核心邏輯。

實作模型過濾器的逐步指南

第 1 步：設定過濾器類別

首先建立一個基本過濾器類，該類將處理動態新增查詢條件。此類將負責根據請求資料應用過濾器。

request = $request;
    }

    public function apply(Builder $builder)
    {
        $this->builder = $builder;

        foreach ($this->filters() as $filter => $value) {
            if (method_exists($this, $filter)) {
                $this->$filter($value);
            }
        }

        return $this->builder;
    }

    public function filters()
    {
        return $this->request->all();
    }
}

第 2 步：建立特定過濾器類別

接下來，為要過濾的模型建立特定的過濾器類別。此類別將擴展基本 QueryFilter 類別並包含每個可過濾屬性的方法。

例如，假設您有一個產品型號，並且您希望按類別、價格和庫存情況進行過濾。

builder->where('category_id', $value);
    }

    public function price($value)
    {
        return $this->builder->where('price', 'builder->where('availability', $value);
    }
}

第 3 步：在控制器中套用過濾器

現在，在控制器中套用過濾器，根據請求參數動態過濾結果。

get();

        return view('products.index', compact('products'));
    }
}

第 4 步：將過濾器範圍新增至模型

為了輕鬆套用篩選器，請為您的 Eloquent 模型新增範圍。

apply($query);
    }
}

第 5 步：在應用程式中使用過濾器

完成所有設定後，現在您可以根據傳入的請求參數輕鬆過濾您的產品模型。例如：

// Example: /products?category=1&price=100&availability=in_stock

此 URL 將根據指定的類別、價格和可用性來過濾產品，並將過濾結果顯示給使用者。

結論

Laravel 中的模型篩選是一種使用乾淨、可重複使用的程式碼處理動態查詢條件的強大方法。透過執行上述步驟，您可以建立一個靈活的過濾系統，從而簡化您的控制器並使您的應用程式更易於維護。這種方法不僅有助於編寫更少的程式碼，而且還使您的查詢更能適應未來的需求。

在您作為 Laravel 開發人員的旅程中，掌握這些模式將顯著提高應用程式的品質和可擴展性。所以，嘗試一下，將您的 Laravel 查詢提升到一個新的水平！

享受！