如何优雅地处理多种电商优惠规则?我用 PHP 封装了一个 Promotion Engine

做电商项目时,经常要处理各种各样的优惠活动:满减、打折、VIP 专属优惠、第二件特价、阶梯优惠......

这些单独实现起来都不复杂,但当你把它们放在一起,就变得混乱起来了。

我自己在工作里写过不少类似的逻辑,每次做法差不多:if/else、switch、各种判断混在一起,过几个月回头看代码,根本不想维护。

于是我干脆写了一个小库,封装了常见的优惠计算逻辑,让这件事更清晰,也能随时在别的项目里用------php-promotion-engine 就是这样来的。


为什么要做这个东西?

一个简单的例子:

  • 购物车里有满 200 减 50 的活动
  • VIP 用户可以再打 9 折
  • 某些商品买三件还能再减 20

这三个优惠叠在一起,怎么算?

  • 是每条规则单独算优惠,最后加在一起?
  • 还是「满减后再打折」的折上折?
  • 或者一件商品只能享受其中一种优惠?

业务里经常会遇到这些问题,而我不想再每个项目都重新造轮子,所以就抽了一个核心逻辑出来,做成 Composer 包。


我把优惠计算分成了三种模式

1. 独立模式(independent)

每条优惠规则都基于商品原价独立计算优惠金额,最后把这些金额加起来。

特点:

  • 所有优惠平行计算,彼此之间没有影响
  • 优惠金额往往会比较大(因为每条规则都按原价算)
  • 运营活动彼此独立时,通常用这种模式

例子:

  • 购物车 300 元,满 200 减 50,VIP 9 折
  • 「满减」算 50 元优惠
  • 「VIP」算 30 元优惠(300元 - 300 元 × 0.9)
  • 最后优惠金额是 80 元,结果是 220 元

2. 折上折模式(sequential)

这里的优惠是「顺序计算」的,每条规则会根据上一条规则之后的价格来继续打折或满减。

很多电商活动是顺序叠加的,比如「满减后再打折」,这就是折上折模式的用武之地。

特点:

  • 优惠金额会按比例分摊给参与优惠的商品,并实时更新商品价格

  • 下一条规则拿到的是更新后的价格,真正意义上的"折上折"

  • 可能出现这样一种情况:

    • 原价满足满减 → 满减后价格降低 → 后面的优惠金额也变少
  • 也可能出现:

    • 某个商品满减后价格降低,下一条满减规则再也不满足条件

例子:

  • 购物车 300 元,满 200 减 50,VIP 9 折
  • 「满减」算 50 元优惠
  • 「VIP」算 25 元优惠(250 元 - 250 元 × 0.9)
  • 最终优惠金额是 75 元(比独立模式的 80 元少)

3. 锁定模式(lock)

这个模式更"严格"------每件商品最多只能享受一条优惠规则 。

一旦被某个优惠"锁定",这件商品就不再参与其他规则的计算。

特点:

  • 适用于「只能享受一次优惠」的场景(比如秒杀、专属券)
  • 优惠不会叠加,运营逻辑更容易控制

例子:

  • A 商品被秒杀价锁定,B 商品参与满减
  • 即使后面有 VIP 折扣,A 商品也不会再打折

这样拆分之后,电商里的几乎所有优惠场景都能归到这三类模式之一 ,只需要在引擎里 setMode() 一下,就能决定计算方式。


怎么用?

安装方式很简单:

bash 复制代码
composer require hejunjie/promotion-engine

然后可以直接写:

php 复制代码
use Hejunjie\PromotionEngine\PromotionEngine;
use Hejunjie\PromotionEngine\Rules\FullReductionRule;
use Hejunjie\PromotionEngine\Rules\VipDiscountRule;
use Hejunjie\PromotionEngine\Models\Cart;
use Hejunjie\PromotionEngine\Models\User;

// 创建一个购物车模型,实际场景中使用需要计算商品的名称/价格/购买数量执行即可
// 可以通过第四个参数来设置标签,执行规则时可以设置需要执行的标签,标签支持设置多个
$cart = new Cart();
$cart->addItem('T恤', 120, 1, ['tag']);
$cart->addItem('牛仔裤', 150, 1, ['tag','promo']);

// 创建一个用户模型,实际场景中仅是用来区分用户是否可以享受关于VIP折扣方面的规则
// 如果没有设置VIP折扣方面的规则,则不会影响任何数据
$user = new User(vip: true);

$engine = new PromotionEngine();
$engine->setMode('sequential'); // 选择折上折模式
$engine->addRule(new Rules\FullReductionRule(100, 30, ['promo'], 1)); // 满 200 减 50, 仅适用于有 promo 标签的商品, 执行顺序 1(数字越小越先执行)
$engine->addRule(new Rules\VipDiscountRule(0.9, ['tag'], 2));      // VIP 9 折, 仅适用于有 tag 标签的商品, 执行顺序 2(数字越小越先执行)

$result = $engine->calculate($cart, $user);

print_r(json_encode($result, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE));

你会得到类似这样的结果:

json 复制代码
{
    "original": 270,
    "discount": 54,
    "final": 216,
    "details": [
        "指定商品满100减30 (-¥30)",
        "VIP 0.9 折 (-¥24)"
    ],
    "items": [
        {
            "name": "T恤",
            "price": 108,
            "qty": 1,
            "tags": [
                "tag"
            ],
            "original_price": 120,
            "locked": false
        },
        {
            "name": "牛仔裤",
            "price": 108,
            "qty": 1,
            "tags": [
                "tag",
                "promo"
            ],
            "original_price": 150,
            "locked": false
        }
    ]
}

这个库能带来什么?

  • 代码更干净 :不用每次都写一堆 if/else,逻辑集中在「规则类」里。
  • 模式可切换 :想独立算就 independent,想折上折就 sequential,换个模式就行。
  • 扩展方便:有新活动?直接加个规则类,比如「第 N 件打折」「阶梯满减」,不用动核心逻辑。

最后

这个库不是大而全的框架,就是一个我在工作中常用到的小工具,我把它整理出来放到 GitHub 上,希望以后别的项目也能用得上,也欢迎你们试试看。

GitHub 地址在这里:github.com/zxc7563598/...

如果你有建议、发现了 bug,或者有好玩的规则想加进来,欢迎 PR。

相关推荐
码事漫谈5 小时前
以后人人都可以成为导演
后端
Resean02235 小时前
Spring 源码分析(二)配置类的解析与扫描
java·后端·spring
一只爱撸猫的程序猿5 小时前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
北城笑笑7 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
ServBay7 小时前
Local harness 将退役,VS Code 本地开发要不要搬到云端?
后端·ai编程·visual studio code
ashiho8 小时前
【LeetCode hot 100】3. 无重复字符的最长子串 (三种解法)
java·数据结构·后端·算法·leetcode·滑动窗口
张一凡939 小时前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent
00后程序员9 小时前
iOS 实时活动怎么开发,Windows 上用 KXBuild 和 ActivityKit 写灵动岛
后端·ios
程序员cxuan9 小时前
推荐 10 个 WorkBuddy 中的邪修用法
人工智能·后端·程序员
Bacon9 小时前
给项目做一次"全身 CT":Agent Skills 生态里的代码体检全链路
前端·人工智能·后端