⛓ Expression Parser v0.2.3
, (*1)
This package allows to evaluate (parse with mapping) large amounts of data in flexible manner, providing various processing functions:, (*2)
🔩 Install
composer install di/expression-parser, (*3)
⚒ Usage
// Signature
$expression = new Expression(string $expression[, array $mappings = []]);
👀 Example
use DI\ExpressionParser\Expression;
$expression = 'or_x(equal([attr1], 1), in_array(explode([keywords]), "hello"))';
$mappings = [
'attr1' => 1,
'keywords' => 'hello,world',
];
$ex = new Expression($expression, $mappings);
echo $ex->value(); // true
Standard function handlers
🔗 Parameter substitution
📥 Input:, (*4)
new Expression(
'[attr1]',
[
'attr1' => 1,
'attr2' => 2,
]
)
📤 Output: 1, (*5)
🔗 Parameter substitution with has() function
📥 Input:, (*6)
new Expression(
'has([attr1])',
[
'attr1' => 1,
'attr2' => 2,
]
)
📤 Output: true, (*7)
🔗 Substitution with in_array() function and scalar value
📥 Input:, (*8)
new Expression(
'in_array([keywords], "hello")',
[
'keywords' => [
'hello',
'world',
],
]
)
📤 Output: true, (*9)
🔗 Nested in_array() and explode() function and scalar value
📥 Input:, (*10)
new Expression(
'in_array(explode([keywords]), "hello")',
[
'keywords' => 'hello,world',
]
)
📤 Output: true, (*11)
🔗 Substitution with matches_in_array() function
📥 Input:, (*12)
new Expression(
'matches_in_array([keywords], "pool")',
[
'keywords' => [
'swimming pool',
],
]
)
📤 Output: true, (*13)
🔗 Nested explode() is_empty() and functions
📥 Input:, (*14)
new Expression(
'is_empty(explode([keywords]))',
[
'keywords' => '',
]
)
📤 Output: true, (*15)
🔗 implode() with inline parameter substitution
📥 Input:, (*16)
new Expression(
'implode(([attr1],[attr2]))',
[
'attr1' => 1,
'attr2' => 2,
]
)
📤 Output: hello world, (*17)
🔗 implode() with inline parameter substitution and a separator flag
📥 Input:, (*18)
new Expression(
'implode(([attr1],[attr2]), ",")',
[
'attr1' => 1,
'attr2' => 2,
]
)
📤 Output: hello,world, (*19)
🔗 explode() with array substitution
📥 Input:, (*20)
new Expression(
'explode([Rooms])',
[
'Rooms' => 'Pantry,Study',
]
)
📤 Output: ['Pantry', 'Study'], (*21)
Standard handlers with one or multiple flags
🔗 explode() with array substitution and a separator flag
📥 Input:, (*22)
new Expression(
'explode([Rooms], ";")',
[
'Rooms' => 'Pantry;Study',
]
)
📤 Output: ['Pantry', 'Study'], (*23)
🔗 get() function with count and nullable flags
📥 Input:, (*24)
new Expression(
'get([attr1], {"count":true, "nullable":false})',
[
'attr1' => [
'a',
'b',
'c',
],
]
)
📤 Output: 3, (*25)
🔗 Nested mapping with map flag in get() function
📥 Input:, (*26)
new Expression(
'get([attr1], {"map":{"a":1, "b": 2, "c": 3}})',
[
'attr1' => 'b',
]
)
📤 Output: 2, (*27)
🔗 Case sensitive matching in array with sensitive flag
📥 Input:, (*28)
new Expression(
'matches_in_array([keywords], "pool", {"sensitive":true})',
[
'keywords' => [
'Swimming Pool',
],
]
)
📤 Output: false, (*29)
Logical handlers
🔗 equal() function
📥 Input:, (*30)
new Expression(
'equal([attr1], 1)',
[
'attr1' => 1,
'attr2' => 2,
]
)
📤 Output: true, (*31)
🔗 great_than() function
📥 Input:, (*32)
new Expression(
'great_than([attr1], 0)',
[
'attr1' => 1,
'attr2' => 2,
]
)
📤 Output: true, (*33)
🔗 Nested not() and equal() functions
📥 Input:, (*34)
new Expression(
'not(equal([attr1], 2))',
[
'attr1' => 1,
'attr2' => 2,
]
)
📤 Output: true, (*35)
🔗 Nested not() and equal() functions
📥 Input:, (*36)
new Expression(
'not(equal([attr1], 2))',
[
'attr1' => 1,
'attr2' => 2,
]
)
📤 Output: true, (*37)
Complex functions with unlimited nesting level
🔗 Multiple function parameter substitution with nesting with and_x()
📥 Input:, (*38)
new Expression(
'and_x(equal([attr1], 1), in_array(explode([attr2]), "hello"))',
[
'attr1' => 1,
'attr2' => 'hello,world',
]
)
📤 Output: true, (*39)
🔗 Multiple function parameter substitution with nesting with or_x()
📥 Input:, (*40)
new Expression(
'or_x(equal([attr1], 1), in_array(explode([attr2]), "hello"))',
[
'attr1' => 1,
'attr2' => 'hello,world',
]
)
📤 Output: true, (*41)
🔗 Multiple function parameter substitution with nesting with or_x() and not()
📥 Input:, (*42)
new Expression(
'not(or_x(equal([attr1], 1), in_array(explode([attr2]), "word")))',
[
'attr1' => 2,
'attr2' => 'hello,world',
]
)
📤 Output: true, (*43)
😳 Multiple nesting with a Closure
📥 Input:, (*44)
new Expression(
'first(take(sort(filter([attr1], [filter_func]), [dir]), [offset]))',
[
'attr1' => [
10,
30,
20,
],
'filter_func' => function (ExpressionParser $context, $value) {
return array_filter($value, function ($item) use ($context) {
return $item < $context->getMappings('filter_attr');
});
},
'filter_attr' => 30,
'dir' => 'desc',
'offset' => 1,
]
)
📤 Output: 20, (*45)
Laravel Collection helpers
The package already has a built-in support of Laravel Collection helpers.
For more informations about the available functions it supports please refer to the original Laravel Collection documentation page., (*46)
🔗 Example usage of Laravel Collection functions
📥 Input:, (*47)
new Expression(
'first(collect([attr1], [attr2]))',
[
'attr1' => 'value 1',
'attr2' => 'value 2',
]
)
📤 Output: 'value 1', (*48)
Extending with custom handlers
In order to extend or override current functionality, you will need to add your own handler class name to config/handlers.php file:, (*49)
use DI\ExpressionParser\Handlers\Logical;
use DI\ExpressionParser\Handlers\Standard;
use DI\ExpressionParser\Handlers\LaravelCollectionAdapter;
return [
Standard::class,
Logical::class,
LaravelCollectionAdapter::class,
// Add custom expression handlers here:
// \Acme\Handlers\CustomHandler::class,
// 'Acme\Handlers\CustomHandler',
];
😍 Contribution
Please feel free to fork and help developing., (*50)
📃 License
MIT, (*51)
Wallogit.com
