adachsoft/rule-evaluator-contract

Contract for evaluating boolean rule expressions against a data context.

v0.1.0 2026-08-10 05:53 UTC

Requires

• php: ^8.3
• symplify/phpstan-rules: ^14.12

Requires (Dev)

• adachsoft/php-code-style: ^0.5.0
• friendsofphp/php-cs-fixer: ^3.95
• phpstan/phpstan: ^2.2
• phpunit/phpunit: ^13.3
• rector/rector: ^2.6

MIT

• Arkadiusz Adach

• expression
• rule
• contract
• rule-engine

Published on Packagist.org on 2026-08-10 03:55 UTC

README

adachsoft/rule-evaluator-contract provides a framework-independent contract for evaluating boolean rule expressions against a data context.

Public API

• RuleEvaluatorInterface defines the evaluation port implemented by rule engines.
• RuleExpressionVo represents a non-empty rule expression without coupling it to a specific expression language.
• RuleEvaluatorExceptionInterface identifies exceptions raised by rule evaluator implementations.
• InvalidRuleExpressionException identifies empty expressions.
• RuleEvaluationFailedException identifies evaluation failures and carries the failed expression.

The package has no production dependencies beyond PHP 8.3. Concrete evaluators belong in implementation packages and may use any suitable expression engine.