A practical functional library for PHP developers.
Heavily inspired by Ramda.js, adapted for PHP needs.
composer require baethon/phlnuse Baethon\Phln\Phln as P;
$fooBars = P::cond([
[P::equals(5), P::always('foo')],
[P::T, P::always('bar')],
]);Later in docs every P:: reference will be used as a mental shortcut to Baethon\Phln\Phln::.
Phln methods are loosely curried. A N-ary method will return a function until all arguments are provided.
$foo = P::curryN(2, function ($left, $right) {
return $left + $right;
});
$foo(1); // returns instance of \Closure
$foo(1, 2); // 3
$foo(1)(2); // 3Partial application is possible with combination of P::partial() and P::__ const. Partial returns a function which accepts arguments which should "fill" gap of missing arguments for callable.
$foos = [1, 2, 3];
$mapFoos = P::partial('\\array_map', [P::__, $foos]);
$mapFoos(function ($f) {
return $f + 100;
}); // [100, 200, 300]For function composition Phln provides pipe() and compose() functions.
$allFoos = P::pipe([
P::filter(P::lte(5)),
P::map(P::always('foo')),
]);
$firstFoo = P::compose([P::head(), $allFoos]);
$allFoos([4, 5, 6]); // ['foo', 'foo']
$firstFoo([4, 5, 6]); // 'foo'Some of Phln methods accept callable as an argument.
To pass another macro as a reference call it without any arguments.
use Baethon\Phln\Phln as P;
$collection = [1, 2, 3, 4];
P::reduce(P::sum(), $collection); // 10Also, you can use P::raw() method wich returns uncurried macro, or pointer to Phln method.
Phln is macroable. This means that it can be extened using P::macro() method:
use Baethon\Phln\Phln as P;
P::macro('foo', function () {
return 'foo';
});
P::foo(); // 'foo'The library takes terminology from Ramda. In most cases, it's perfectly fine, until one gets to the concept of object.
Ramda treats objects as dictionaries. In JavaScript, there's only one type which can act as a dictionary. It's ... object.
In PHP things get complicated. It's possible to use arrays and objects as dictionaries. This way Phln has to treat both of those types as an object.
For compatibility reason, all functions which return object will return array.
./vendor/bin/phpunit