zerifas / collections
Tools for collections of data in PHP
v1.1.0
2016-11-02 15:18 UTC
Requires
- php: >= 5.5
Requires (Dev)
- phpunit/phpunit: ^4.8
- squizlabs/php_codesniffer: ^2.0
This package is auto-updated.
Last update: 2024-10-29 04:59:14 UTC
README
Tools for collections of data in PHP.
Installation
$ composer require zerifas/collections
Usage
There are two ways to use this library:
- The
Arr
helper class that consists of static methods. The first parameter is always to array to operate on. - The
ArrayWrapper
class that wraps a plain array in anArrayObject
Arr
helper
Get a single item
use Zerifas\Collections\Arr; $arr = [ 'key1' => 'value1', 'key2' => 'value2', ]; $item = Arr::get($arr, 'key1'); // 'value1' $item = Arr::get($arr, 'NONE'); // null $item = Arr::get($arr, 'NONE', 'default value'); // 'default value'
Filter and Map
Example:
use Zerifas\Collections\Arr; $arr = [ 'key1' => 1, 'key2' => 2, 'key3' => 3, ]; $filtered = Arr::filter($arr, function ($value, $key) { return $key !== 'key1'; }); $mapped = Arr::map($filtered, function ($value, $key) { return 'value ' . $value; }); var_dump($mapped);
Outputs:
array(2) {
'key2' =>
string(7) "value 2"
'key3' =>
string(7) "value 3"
}
ArrayWrapper class
Get a single item
use Zerifas\Collections\ArrayWrapper; $arr = new ArrayWrapper([ 'key1' => 'value1', 'key2' => 'value2', ]); $item = $arr->get('key1'); // 'value1' $item = $arr->get('NONE'); // null $item = $arr->get('NONE', 'default value'); // 'default value'
Filter and Map
Example:
use Zerifas\Collections\ArrayWrapper; $arr = [ 'key1' => 1, 'key2' => 2, 'key3' => 3, ]; $result = (new ArrayWrapper($arr)) ->filter(function ($value, $key) { return $key !== 'key1'; }) ->map(function ($value, $key) { return 'value ' . $value; }) ->toArray() ; var_dump($result);
Outputs:
array(2) {
'key2' =>
string(7) "value 2"
'key3' =>
string(7) "value 3"
}
You can also wrap a plain array using the Arr
helper:
$arr = [1, 2, 3]; $result = Arr::wrap($arr)->filter(function (…) { … })->toArray();