/phunctional

λ PHP functional library

Primary LanguagePHP

Phunctional, because functional programming matters.

Lambdish MIT License Version Monthly Downloads Travis Build Status

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]

Functions documentation

You can find the functions documentation here.

License

The Phunctional library is licensed under the MIT license.