嘿,各位开发者朋友们!
你们有没有遇到过这样的场景:项目需求变更频繁,业务逻辑像“俄罗斯套娃”一样层层嵌套,各种
if-else if-else把代码文件撑得老长,改动一处牵一发动全身?又或者,你需要一套规则既能在前端进行实时校验,又能确保后端逻辑一致性,甚至还要能让运营人员通过后台配置来调整这些规则?
我最近就深陷这样的困境。手头一个电商项目,商品促销、用户积分、订单折扣等模块的业务规则异常复杂。比如,“如果用户是VIP会员,且订单金额超过500元,并且购买了指定品类的商品,则享受8折优惠,但优惠上限为100元”。这种规则不仅条件多,还可能随时调整。一开始,我尝试把这些逻辑硬编码到PHP里,结果可想而知:代码臃肿、难以阅读、维护成本奇高。每次业务方提出修改,都得走一遍开发、测试、部署的流程,效率低下,还容易出错。
更糟糕的是,部分规则需要在前端做实时反馈,这就意味着我得在 JavaScript 里再写一套几乎相同的逻辑。这不仅造成了代码重复,也增加了两端逻辑不一致的风险。我开始思考,有没有一种方法,能把这些业务规则从代码中抽离出来,让它们变得更灵活、更易于管理,甚至能直接存储在数据库中,实现真正的动态配置?
就在我一筹莫展之际,
jwadhams/json-logic-php这个 Composer 包映入了我的眼帘。它简直就是为解决这类问题而生的!
立即学习“PHP免费学习笔记(深入)”;
什么是 jwadhams/json-logic-php
?
简单来说,
jwadhams/json-logic-php是一个 PHP 库,它能够解析并执行 JsonLogic 格式定义的规则。JsonLogic 是一种将复杂比较和布尔运算符序列化为 JSON 的格式。它的核心思想是:将业务逻辑用一种通用的、跨语言的 JSON 结构来描述,然后由各自语言的解释器来执行。这意味着,你可以在 PHP 后端使用它,也可以在 JavaScript 前端(配合
json-logic-js)使用它,甚至可以将这些规则直接存储在数据库的 JSON 字段中。
这不就是我苦苦寻找的“银弹”吗?
如何使用 jwadhams/json-logic-php
?
首先,通过 Composer 轻松安装:
composer require jwadhams/json-logic-php
安装完成后,你就可以开始定义和执行你的业务规则了。JsonLogic 的规则结构非常直观:它总是一个键值对,其中键是操作符(如
==,
>,
and,
or等),值是一个数组,包含操作符的参数。
1. 简单规则示例:
use JWadhams\JsonLogic; // 检查 1 是否等于 1 $rule = ["==" => [1, 1]]; $result = JsonLogic::apply($rule); // 结果:true echo "1 == 1 ? " . ($result ? 'true' : 'false') . "\n"; // 检查 "apples" 是否等于 "oranges" $rule = ["==" => ["apples", "oranges"]]; $result = JsonLogic::apply($rule); // 结果:false echo "apples == oranges ? " . ($result ? 'true' : 'false') . "\n";
2. 复合逻辑示例:
你可以轻松地将多个规则组合起来,形成更复杂的逻辑:
use JWadhams\JsonLogic;
// 检查 (3 > 1) 并且 (1 < 3)
$rule = [
"and" => [
[">" => [3, 1]],
["<" => [1, 3]]
]
];
$result = JsonLogic::apply($rule); // 结果:true
echo "(3 > 1) AND (1 < 3) ? " . ($result ? 'true' : 'false') . "\n";这在 PHP 中相当于
((3 > 1) && (1 < 3))。是不是感觉 JSON 结构清晰了很多?
3. 数据驱动的规则:
光有静态规则还不够,我们还需要根据实际数据来判断。
var操作符可以帮助你从传入的数据上下文中获取值:
use JWadhams\JsonLogic;
$rules = [
"and" => [
// 检查温度是否低于 110
["<" => [["var" => "temp"], 110]],
// 检查馅料是否为 "apple"
["==" => [["var" => "pie.filling"], "apple"]]
]
];
// 场景一:符合规则
$data1 = ["temp" => 100, "pie" => ["filling" => "apple"]];
$result1 = JsonLogic::apply($rules, $data1); // 结果:true
echo "场景一结果: " . ($result1 ? 'true' : 'false') . "\n";
// 场景二:不符合规则(温度过高)
$data2 = ["temp" => 120, "pie" => ["filling" => "apple"]];
$result2 = JsonLogic::apply($rules, $data2); // 结果:false
echo "场景二结果: " . ($result2 ? 'true' : 'false') . "\n";
// 场景三:不符合规则(馅料不对)
$data3 = ["temp" => 100, "pie" => ["filling" => "cherry"]];
$result3 = JsonLogic::apply($rules, $data3); // 结果:false
echo "场景三结果: " . ($result3 ? 'true' : 'false') . "\n";通过
var操作符,你可以轻松访问数据对象的属性(如
pie.filling)或数组元素(如
var => 1访问索引为 1 的元素)。
总结与应用效果
jwadhams/json-logic-php给我带来了巨大的便利和效率提升:
- 业务逻辑与代码解耦: 规则不再硬编码在 PHP 文件中,而是以 JSON 格式独立存在。这意味着业务规则的修改不再需要改动代码,只需要调整 JSON 配置即可,大大降低了维护成本和部署风险。
- 实现动态规则引擎: 我可以将这些 JSON 规则存储在数据库中,通过后台管理界面让运营人员自行配置和调整促销、折扣等业务规则,实现了真正的“业务驱动开发”。
-
前端后端逻辑一致: 配合
json-logic-js
,我可以在前端和后端使用同一套 JSON 规则,确保了逻辑的一致性,避免了因两端实现差异导致的问题。 -
提高可读性和可测试性: JSON 格式的规则比复杂的
if-else
结构更易于阅读和理解。同时,独立化的规则也更容易进行单元测试。
现在,我的业务逻辑模块变得异常清晰和灵活。当新的需求来临时,我不再需要修改大量的PHP代码,而是直接调整 JSON 规则或在数据库中更新它们。这不仅节省了大量的开发时间,也让系统更加健壮和适应变化。
如果你也正为管理复杂多变的业务逻辑而烦恼,强烈推荐你尝试一下
jwadhams/json-logic-php。它将彻底改变你处理业务规则的方式!










