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 许可。