robinkanters/streams-php

A port of the Streams library for Java8. Let's make PHP cooler.

Streams

, _(*1)

Streams is a port of the Streams library for PHP. It makes working with collections super pleasant., _(*2)

Installation

Just add the following to your composer.json file:, _(*3)

"robinkanters/streams-php": "dev-master"

Usage

An example with the Yii ActiveRecord lib:, _(*4)

<?php

use Streams as S;

$collection = Car::model()->findAll(); // Returns an array of Car objects
$carStream = new S\Stream($collection);

$newCollection = $carStream
    ->filter(function( $car ) {
        return ($car->price > 36000); // return only expensive cars!
    })->map(function( $car ) {
        $car->setCo2EmissionTaxes(20); // Since is an expensive car, lets make the people who drive it more poor :D
        return $car;
    })->getElements();

Available functions

Even though this library is under active development, the currently available methods are:, _(*5)

map(callable $callback)

As in every functional programming language, map takes a function as argument and applies it to each element in the array, returning a new array with the results., _(*6)

filter(callable $callback)

Takes a function as argument and applies it to each element in the collection. It returns a new collection containing all elements where the callback returned true., _(*7)

allMatch(callable $predicate)

Returns whether all the elements in the stream match the given predicate, _(*8)

anyMatch(callable $predicate)

Returns whether any the elements in the stream match the given predicate, _(*9)

concat(Stream $a, Stream $b)

Creates a lazily concatenated stream whose elements are all the elements of the first stream followed by all the elements of the second stream., _(*10)

count()

Returns the count of elements in the stream, _(*11)

distinct()

Returns a new stream consisting of the distinct elements of the stream, _(*12)

Hacking

Please, submit your Pull Requests, and make sure that the build passes., _(*13)