flume/flume-php

Filter Logic Unification & Mapping Engine

dev-main 2025-10-19 13:52 UTC

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.89
• phpstan/phpstan: ^2.1
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/phpunit: ^11.5

MIT

• Thomas Meschke

README

Compose Logic - let it flow.

💡 What is Flume?

Flume is a universal framework to define, combine and interpret filter logic. Write your filter once, use it everywhere: in SQL, JSON, APIs or custom evaluators.

The Core of Flume are the easy to grasp logical components (e.g. AndFilter, OrFilter, EqualityFilter, GreaterThanFilter and more) you can combine as you like and interpret as you like using custom compilers.

🧱 Example Setup

Simple setup in PHP:

// e.g. a filter representing (age > 18) AND (country = 'US')

$filter = new AndFilter([
    new GreaterThanFilter('age', 18),
    new EqualsFilter('country', 'DE')
]);

// used with the SQL Filter Expression Compiler:
$compiler = new SqlFilterExpressionCompiler();
$sql = $compiler->compile($filter);

echo $sql;
// => "(age > 18) AND (country = 'DE')"

Installation

Via Composer

composer require flume/flume-php