Hyperf 不内置规则引擎，需手动集成 Symfony ExpressionLanguage 并注入上下文；因其同步阻塞，须避免协程退化，且变量需显式传入、函数需手动注册，Hoa/Ruler 因兼容性差不推荐。
Hyperf 本身不内置规则引擎，也不原生支持 Hoa/Ruler 或 Symfony ExpressionLanguage 的自动集成。想在 Hyperf 里跑规则逻辑，得自己搭骨架——不是加个包就能用，而是要明确「规则谁来解析」「上下文怎么传」「执行在哪发生」。
为什么不能直接 use ExpressionLanguage::evaluate() 就完事
ExpressionLanguage 是同步阻塞的，而 Hyperf 默认运行在协程环境；直接在协程中调用它不会报错，但会退化成同步执行，失去并发优势。更关键的是：ExpressionLanguage 不知道你的模型、服务、用户上下文在哪，你得手动把变量数组塞进去，一不留神就漏传或类型错乱。
- 常见错误现象：
Variable "user" is not defined—— 传进evaluate()的$variables数组里没放'user' => $user - 如果规则里写了
user.balance > 1000，但$user是个 DTO 或数组，没有balance属性，就会抛PropertyAccess异常 - 规则字符串若来自数据库或管理后台，必须严格校验和沙箱隔离，否则
evaluate('shell_exec("rm -rf /")')这类注入就不是玩笑
用 Symfony ExpressionLanguage + Hyperf 容器做安全封装
核心思路是：把 ExpressionLanguage 实例注册为容器服务，并通过构造函数注入所需上下文对象（如 User、Order），避免每次都手拼变量数组。
- 先安装依赖：
composer require symfony/expression-language - 在
config/autoload/dependencies.php中注册：
return [
SymfonyComponentExpressionLanguageExpressionLanguage::class => HyperfDiContainer::class,
];
- 写一个规则执行器，例如
AppServiceRuleEvaluator：
class RuleEvaluator
{
public function __construct(
private SymfonyComponentExpressionLanguageExpressionLanguage $el,
private User $user,
private Order $order
) {}
public function evaluate(string $expr): mixed
{
return $this->el->evaluate($expr, [
'user' => $this->user,
'order' => $this->order,
'now' => new DateTime(),
]);
}
}
- 这样调用时，
$evaluator->evaluate('user.level === "vip" and order.total > 500')才真正解耦且可测 - 注意：不要在
evaluate()里调用 DB 查询方法（比如user.posts.count()），那会触发 N+1；所有依赖数据应提前加载好并注入
Hoa/Ruler 在 Hyperf 里基本不推荐
Hoa/Ruler 是一个老式规则引擎，依赖 hoa/compiler，PHP 8.1+ 兼容性差，且其规则定义方式（DSL + AST 解析）与 Hyperf 的协程生命周期不匹配。实测中容易出现：
-
Cannot use object of type Hoa\Ruler\Visitor\DefaultVisitor as array—— 因为它的Visitor类不是无状态的，在协程间复用会出错 - 文档稀少，社区维护停滞，连最新版 Packagist 上的
hoa/ruler都标着abandoned - 规则结构强绑定于
Rule对象树，没法像ExpressionLanguage那样直接喂字符串，开发体验僵硬
除非你已有遗留系统重度依赖 Hoa，否则别碰。真要 DSL，不如自己用 PHP 数组定义规则，再写个轻量解析器。
规则变更后如何热更新不重启服务
Hyperf 没有规则热重载机制。如果你把规则存数据库或配置中心，每次执行都从 DB 查一次，性能会崩。正确做法是：
- 用
@Value注入配置项，配合hyperf/config-center实现配置监听 - 规则字符串缓存在
HyperfCache中，设置合理 TTL（比如 30 秒），避免缓存雪崩 - 关键规则（如风控阈值）建议加一层内存标记，如
AtomicCounter记录版本号，执行前比对是否过期 - 绝对不要在
__construct里加载规则——构造函数只做依赖注入，规则加载应延迟到第一次evaluate()调用时（懒加载）
最易被忽略的一点：规则表达式里的函数调用（如 date_diff()）必须显式注册到 ExpressionLanguage，Hyperf 不会自动帮你桥接 Laravel 的辅助函数或框架全局函数。
