rulerz

統治者Z

該項目不再維護，如果您有興趣成為維護者，請與我聯繫

規範的中心思想是將如何匹配候選對象的語句與其匹配的候選對象分開。

規格，由 Eric Evans 和 Martin Fowler 解釋

RulerZ 是規範模式的 PHP 實現，它強調三個主要面向：

• 一個簡單且與資料無關的 DSL，用於定義業務規則和規範，
• 檢查候選人是否滿足規範的能力，
• 過濾或查詢任何資料來源以僅檢索符合規範的候選者的能力。

介紹

業務規則可以使用專用語言編寫為文本，非常接近 SQL，在這種情況下，我們將它們稱為規則，或者可以將它們封裝在單一類別中並稱為規範。

一旦編寫了規則（或規範），就可以使用它來檢查單一候選是否滿足它或直接查詢資料來源。

本機支援以下資料來源：

• 數組的數組，
• 物件數組。

對其中每一個的支援都是由一個附加函式庫提供的：

• Doctrine DBAL 查詢建構器：rulerz-php/doctrine-dbal，
• Doctrine ORM 查詢建構器：rulerz-php/doctrine-orm，
• Pomm 模型：rulerz-php/pomm，
• Elasticsearch（使用官方客戶端：rulerz-php/elasticsearch，
• Solr（使用日光浴室：rulerz-php/solarium，
• Laravel 的 Eloquent ORM：rulerz-php/eloquent。

殺手級功能：當與 Doctrine、Pomm 或 Elasticsearch 配合使用時，RulerZ 能夠直接在查詢中轉換規則，無需事先取得資料。

這很酷，但為什麼我需要它？

首先，您可以用專用的、簡單的語言來表達業務規則。然後，這些業務規則可以封裝在規範類別中，重複使用和組合以形成更複雜的規則。規範現在可以重複使用和測試。最後但並非最不重要的一點是，這些規則既可用於檢查候選人是否符合要求，也可用於過濾任何資料來源。

如果您仍然需要被說服，您可以閱讀本文中的整個推理。

快速使用

作為快速概述，我們建議看一個操作簡單規則和多個資料來源的小範例。

1. 寫一條規則

此後的規則描述的是「高排名女性玩家」（基本上是積分超過 9000 分的女性玩家）。

 $ highRankFemalesRule = ' gender = "F" and points > 9000 ' ;

2. 定義資料來源

我們有以下資料來源：

 // a Doctrine QueryBuilder
$ playersQb = $ entityManager
    -> createQueryBuilder ()
    -> select ( ' p ' )
    -> from ( ' EntityPlayer ' , ' p ' );

// or an array of arrays
$ playersArr = [
    [ ' pseudo ' => ' Joe ' ,   ' gender ' => ' M ' , ' points ' => 2500 ],
    [ ' pseudo ' => ' Moe ' ,   ' gender ' => ' M ' , ' points ' => 1230 ],
    [ ' pseudo ' => ' Alice ' , ' gender ' => ' F ' , ' points ' => 9001 ],
];

// or an array of objects
$ playersObj = [
    new Player ( ' Joe ' ,   ' M ' , 40 , 2500 ),
    new Player ( ' Moe ' ,   ' M ' , 55 , 1230 ),
    new Player ( ' Alice ' , ' F ' , 27 , 9001 ),
];

3. 使用規則查詢資料來源

對於我們的任何資料來源，檢索結果就像呼叫filter方法一樣簡單：

 // converts the rule in DQL and makes a single query to the DB
$ highRankFemales = $ rulerz -> filter ( $ playersQb , $ highRankFemalesRule );
// filters the array of arrays
$ highRankFemales = $ rulerz -> filter ( $ playersArr , $ highRankFemalesRule );
// filters the array of objects
$ highRankFemales = $ rulerz -> filter ( $ playersObj , $ highRankFemalesRule );

3.（之二）檢查候選人是否符合規則

給定一個候選者，檢查它是否滿足規則可以歸結為呼叫satisfies方法：

 $ isHighRankFemale = $ rulerz -> satisfies ( $ playersObj [ 0 ], $ highRankFemalesRule );

更進一步

查看文檔，了解 RulerZ 可以為您做什麼。

執照

該庫已獲得 MIT 許可。