millipress/millirules

A flexible, framework-agnostic rule evaluation engine for PHP 7.4+

v0.4.0 2025-12-03 15:50 UTC

Requires

• php: >=7.4

Requires (Dev)

• pestphp/pest: ^1.23
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^9.5
• squizlabs/php_codesniffer: ^3.7
• szepeviktor/phpstan-wordpress: ^1.3

GPL-2.0-or-later

• Philipp Wellmer

README

A flexible, framework-agnostic rule evaluation engine for PHP 7.4+.

Overview

MilliRules is a powerful rule engine that allows you to define complex conditional logic using a fluent API. It's designed to be framework-agnostic while providing specialized support for HTTP and WordPress environments.

Features

• Fluent API: Build complex rules with an intuitive, chainable syntax
• Framework Agnostic: Core engine works with any PHP application
• Lazy-Loaded Context: On-demand loading of context data for optimal performance
• HTTP Support: Built-in conditions for request handling
• WordPress Integration: Native support for WordPress queries and context
• Extensible: Easy to add custom conditions and actions
• snake_case Convention: Consistent naming throughout the API
• PHP 7.4+ Compatible: Works with modern PHP versions

Installation

composer require millipress/millirules

Quick Start

use MilliRules\Rules;

// Simple HTTP rule
Rules::create('api_check')
    ->when()->request_url('/api/*')
    ->then()->custom( 'run_check', function($context) {
        // Your action here
    })
    ->register();

Documentation

See the /docs directory for detailed documentation.

License

GPL-2.0-or-later