blueeon/php-logical-dsl

A simple DSL for WHEN and THEN

dev-master 2017-11-29 13:19 UTC

Requires

• php: >=5.4.0

Requires (Dev)

• php: >=5.4.0
• phpunit/phpunit: ^5.7

MIT

• blueeon

• php
• DSL
• rule
• logical

README

A simple DSL for WHEN and THEN

Installation

composer require blueeon/php-logical-dsl

Packgist Page

https://packagist.org/packages/blueeon/php-logical-dsl

Try it!

Features

Syntax Definition

Prototype

/**
 *
 *Test rules
 */
rule_name{
    WHEN  req.order.order_from = 11 AND req.order.stock_channel NOT IN( 'cn-order') AND req.order.price >= 1000
    THEN
        (res.mihome = 100 AND res.price = 100 AND WEIGHT=30),
        (res.mihome = 112 AND res.price = 100 AND WEIGHT=70)
    PRIORITY = 1
}
rule_name{
    WHEN  req.order.order_from = 11 AND req.order.stock_channel NOT IN( 'cn-order') AND req.order.price >= 1000
    THEN
        (res.mihome = 100 AND res.price = 100 AND WEIGHT=30),
        (res.mihome = 112 AND res.price = 100 AND WEIGHT=70)
    PRIORITY = 2
}
[RULE NAME]{
    WHEN        [[Condition]...]
    THEN        [[Result]...]
    PRIORITY =  [priority]
}
...

Example

1. simple

/**
 * 一个简单例子
 */


rule1{
    when    req.order.order_type = 10
    THEN    res.price = 110
}
rule2{
    WHEN    req.order.order_type = 11
    THEN    res.price = 500
}

2. With PRIORITY

/**
 * 一个带权重的简单例子
 */
rule1{
    when    req.order.order_type = 10
    THEN    res.price = 110
    PRIORITY = 1
}
rule2{
    WHEN    req.order.order_type = 10 AND req.order.order_from = 12
    THEN    res.price = 500
    PRIORITY = 100
}

3. Multiple result

/**
 * 随机按比例返回结果
 */
rule1{
    when    req.order.order_type = 10
    THEN    (res.express = 110 AND WEIGHT = 10),
            (res.express = 120 AND WEIGHT = 90)
}
rule2{
    WHEN    req.order.order_type = 11
    THEN    (res.express = 114 AND WEIGHT = 10),
            (res.express = 118 AND WEIGHT = 90)
}

4. Complex example

/**
 * 带权重,多返回值,复杂判断逻辑
 */
rule1{
    WHEN    req.order.order_type = 10
    AND(
            req.order.stock_channel  NOT IN ('cn-tmall')
            OR  req.order.price >= 1000
            AND req.order.order_from IN(1,2,3,12)
    )
    THEN
        (res.mihome = 100 AND res.price = 110 AND WEIGHT=30),
        (res.express = 14  AND res.mihome = 112 AND res.price = 1200 AND WEIGHT=70)
    PRIORITY = 1
}
rule2{
    WHEN    req.order.order_from = 12 
            AND req.order.stock_channel IN( 'cn-order') 
            AND req.order.price >= 1000
    THEN    res.mihome = 100 AND res.price = 1000
    PRIORITY = 10
}

5. Return a function and execute it

/**
 * 返回一个方法,并且执行这个方法,如果找不到这个方法,则抛一个异常,仅支持静态方法,且需完整的可访问到的命名空间
 */


rule1{
    when    req.order.order_type = 10
    THEN    res.mihome = 100 AND res.mihome = PHPLogicalDSLTests\data\CommonFunction::getMihome(100)
}
rule2{
    WHEN    req.order.order_type = 11
    THEN    res.mihome = 112 AND res.mihome = PHPLogicalDSLTests\data\CommonFunction::getMihome(112)
}

Supported Operator

Operator	name	cn_name	remark
*	multiply	乘
/	divide	除
%	mod	取余
+	plus	加
-	minus	减
>	gt	大于
<	lt	小于
>=	Greater than or equal to	大于等于
<=	Less than or equal to	小于等于
IN	in	在...中
NOTIN	not in	不在...中
EXSIT	exsit	存在
NOTEXSIT	not exsit	不存在
=	equal	等于
!=	not equal	不等于
AND	and	和、且
OR	or	或者

Usefull Tools