akamon/phunctional

λ PHP functional library

v2.1.0 2020-09-18 07:22 UTC

Requires

• php: >=7.2

Requires (Dev)

• phpstan/phpstan: ^0.11.16
• phpunit/phpunit: ^8.4

MIT

• Eloi Poch
• Jorge Ávila
• Rafa Gómez

• generator
• php
• library
• functional
• lambda

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.