akamon / phunctional
λ PHP functional library
Installs: 9 383
Dependents: 0
Suggesters: 0
Security: 0
Stars: 351
Watchers: 23
Forks: 42
Open Issues: 2
Requires
- php: >=7.2
Requires (Dev)
- phpstan/phpstan: ^0.11.16
- phpunit/phpunit: ^8.4
README
Phunctional, because functional programming matters.
Lambdish's Phunctional is a little library that tries to bring to PHP some aspects of functional programing with util high order functions and functions for manage iterables.
About
Phunctional is heavily inspired by Clojure and some other PHP libraries like iter, compose and felpado.
The main principles that we have in mind developing this library are:
- A collection can be any iterable PHP object, arrays or generators
- Favor composition vs inheritance
- Be lazy when you can
- Avoid state, state is (usually) evil!
- Simplicity over easiness
- Break the above rules if it makes sense
All of this can be resumed with a word: Immutability.
Installation
To install it with composer:
composer require lambdish/phunctional
Simple usage
The first is to import every function you're going to use, for example:
use function Lambdish\phunctional\map;
And then you'll be able to use it:
map( function ($number) { return $number + 10; }, [1, 2, 3, 4, 5] ); // => [11, 12, 13, 14, 15]
And do something more complex like:
use function Lambdish\Phunctional\pipe; use const Lambdish\Phunctional\{filter_null, reverse, first}; $lastNonNullableValue = pipe(filter_null, reverse, first); $lastNonNullableValue(['first', null, 'other', 'last non nullable', null, null]); // => "last non nullable"
Here we're using the provided constants, that acts like an alias for the functions full qualified namespace
(and therefore, are callable
).
Documentation
You can find the functions documentation here.