cline/ruler

Fluent rule engine with proposition-based evaluation and 50+ operators for building conditional business logic

3.0.2 2025-10-25 06:33 UTC

Requires

• php: ^8.4.0
• mtdowling/jmespath.php: ^2.8
• symfony/expression-language: ^7.3.2

Requires (Dev)

• cline/php-cs-fixer: ^1.0.5
• driftingly/rector-laravel: ^2.1.1
• ergebnis/composer-normalize: ^2.49@dev
• laravel/pint: ^1.25.1
• orchestra/testbench: ^10.6
• pestphp/pest: ^3.8.4
• pestphp/pest-plugin-laravel: ^3.2
• pestphp/pest-plugin-type-coverage: ^3.6.1
• phpstan/phpstan: ^2.1.31
• rector/rector: ^2.2.5
• symfony/var-dumper: ^7.3.4

MIT

• Brian Faust

• php
• DSL
• Context
• Evaluation
• fluent-interface
• operators
• rule-engine
• business-rules
• conditional-logic
• proposition

README

Fluent rule engine with proposition-based evaluation and 50+ operators for building conditional business logic.

Requirements

Requires PHP 8.4+

Installation

composer require cline/ruler

Documentation

Core Concepts

• Quick Reference - Core concepts and common patterns
• DSL Syntax Overview - Understanding DSL capabilities

Domain-Specific Languages

• Wirefilter DSL - Cloudflare-style filtering syntax
• SQL WHERE DSL - Familiar SQL WHERE clause syntax
• MongoDB Query DSL - NoSQL query expressions
• GraphQL Filter DSL - GraphQL-style filtering
• LDAP Filter DSL - Directory service queries
• JMESPath DSL - JSON path expressions
• Natural Language DSL - Human-readable rules

Change log

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please use the GitHub security reporting form rather than the issue queue.

Credits

• Brian Faust
• bobthecow/Ruler
• All Contributors

License

The MIT License. Please see License File for more information.