library phunctional

akamon/phunctional

λ PHP functional library

, _(*1)

Phunctional, because functional programming matters., _(*2)

, _(*3)

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., _(*4)

, _(*5)

About

Phunctional is heavily inspired by Clojure and some other PHP libraries like iter, compose and felpado., _(*6)

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, _(*7)

All of this can be resumed with a word: Immutability., _(*8)

Installation

To install it with composer:, _(*9)

composer require lambdish/phunctional

Simple usage

The first is to import every function you're going to use, for example:, _(*10)

use function Lambdish\phunctional\map;

And then you'll be able to use it:, _(*11)

map(
    function ($number) {
        return $number + 10;
    },
    [1, 2, 3, 4, 5]
);

// => [11, 12, 13, 14, 15]

And do something more complex like:, _(*12)

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)., _(*13)

Documentation

You can find the functions documentation here., _(*14)