Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/izica/php-collection
Tools and utilities for working with arrays
https://github.com/izica/php-collection
array arrays collection collections illuminate library lodash php php-array php-collection php-library php-lodash php5 php56 php7 tool tools utilities utility utils
Last synced: 3 months ago
JSON representation
Tools and utilities for working with arrays
- Host: GitHub
- URL: https://github.com/izica/php-collection
- Owner: izica
- License: mit
- Created: 2019-03-25T14:52:48.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-04-09T01:03:01.000Z (almost 2 years ago)
- Last Synced: 2024-09-29T19:23:16.761Z (4 months ago)
- Topics: array, arrays, collection, collections, illuminate, library, lodash, php, php-array, php-collection, php-library, php-lodash, php5, php56, php7, tool, tools, utilities, utility, utils
- Language: PHP
- Homepage:
- Size: 22.5 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Php collection
inspired by Illuminate\Support\Collection and Lodash
### Usage
```
composer require izica/php-collection
```
### Notice
Every method will returns new collection, not mutated collection;
```php
$collection = PhpCollection:collect([100, 200, 300, 400]);
$collection2 = $collection->filter(function($item){
return $item > 200;
})
/*
$collection != $collection2
*/
```
### Documentation
* [collect](#collectarray)
* [implode OR join](#implodearray----serializer---or-joinarray----serializer--)
* [pluck](#pluckkey)
* [only](#onlykeys)
* [exclude](#excludekeys)
* [filter](#filterfunctionitem)
* [map](#mapfunctionitem)
* [keyBy](#keybykey)
* [groupBy](#groupbykey)
* [find](#findfunctionitem)
* [some OR contains](#somefunctionitem-or-containsfunctionitem)
* [every](#everyfunctionitem)
* [sort](#sortfunctionitem)
* [values](#values)
* [first](#first)
* [last](#last)
* [count](#count)
* [all or toArray](#all-or-toarray)
* [toJson](#tojson)
#### collect($array, $isSingleElement = false)
```php
$products = [
["id" => 1, "name" => "product 1", "price" => 100],
["id" => 2, "name" => "product 2", "price" => 200],
["id" => 3, "name" => "product 3", "price" => 300]
];
$collection = PhpCollection:collect($products);
// make collection from single element
$collection = PhpCollection:collect($products[0], true);
```
#### implode($array = ", ", $serializer = "") OR join($array = ", ", $serializer = "")
```php
$collection = PhpCollection:collect([100, "data", 300, 400])->implode();
/*
100, data, 300, 400
*/
$products = [
["id" => 1, "name" => "product 1", "price" => 100],
["id" => 2, "name" => "product 2", "price" => 200],
["id" => 3, "name" => "product 3", "price" => 300]
];
// should return string
$serializer = function($item){
return "{$item['name']}-{$item['price']}$"; // or for example -- return json_encode($item);
};
$collection = PhpCollection:collect($products)->implode(", ", $serializer);
/*
product 1-100$, product 2-200$, product 3-300$
*/
```
#### pluck($key)
```php
$products = [
["id" => 1, "name" => "product 1", "price" => 100],
["id" => 2, "name" => "product 2", "price" => 200],
["id" => 3, "name" => "product 3", "price" => 300]
];
$collection = PhpCollection:collect($products)->pluck("id")->all();
/*
[1, 2, 3]
*/
$collection = PhpCollection:collect($products)->pluck("name")->all();
/*
["product 1", "product 2", "product 3"]
*/
```
#### only($keys)
```php
$products = [
["id" => 1, "name" => "product 1", "price" => 100],
["id" => 2, "name" => "product 2", "price" => 200],
["id" => 3, "name" => "product 3", "price" => 300]
];
$collection = PhpCollection:collect($products)->only(["id", "name"])->all();
/*
[
["id" => 1, "name" => "product 1"],
["id" => 2, "name" => "product 2"],
["id" => 3, "name" => "product 3"]
]
*/
$collection = PhpCollection:collect($products)->only(["id", "name" => "title"])->all();
/*
[
["id" => 1, "title" => "product 1"],
["id" => 2, "title" => "product 2"],
["id" => 3, "title" => "product 3"]
]
*/
```
#### exclude($keys)
```php
$products = [
["id" => 1, "name" => "product 1", "price" => 100],
["id" => 2, "name" => "product 2", "price" => 200],
["id" => 3, "name" => "product 3", "price" => 300]
];
$collection = PhpCollection:collect($products)->exclude(["name"])->all();
/*
[
["id" => 1, "price" => 100],
["id" => 2, "price" => 200],
["id" => 3, "price" => 300]
]
*/
```
#### filter(function($item))
```php
$products = [
["id" => 1, "name" => "product 1", "price" => 100],
["id" => 2, "name" => "product 2", "price" => 200],
["id" => 3, "name" => "product 3", "price" => 300]
];
$collection = PhpCollection:collect($products)
->filter(function($item){
return $item["price"] > 100
})
->all();
/*
[
["id" => 2, "name" => "product 2", "price" => 200],
["id" => 3, "name" => "product 3", "price" => 300]
]
*/
```
#### map(function($item))
```php
$products = [
["id" => 1, "name" => "product 1", "price" => 100],
["id" => 2, "name" => "product 2", "price" => 200],
["id" => 3, "name" => "product 3", "price" => 300]
];
$collection = PhpCollection:collect($products)
->map(function($item){
$item["pricex2"] = $item["price"] * 2;
return $item;
})
->all();
/*
[
["id" => 1, "name" => "product 1", "price" => 100, "pricex2" => 200],
["id" => 2, "name" => "product 2", "price" => 200, "pricex2" => 400],
["id" => 3, "name" => "product 3", "price" => 300, "pricex2" => 600]
]
*/
```
#### keyBy($key | function($item))
```php
$products = [
["id" => 16, "name" => "product 1", "price" => 100],
["id" => 22, "name" => "product 2", "price" => 200],
["id" => 31, "name" => "product 3", "price" => 300]
];
$collection = PhpCollection:collect($products)->keyBy("id")->all();
/*
[
16 => ["id" => 1, "name" => "product 1", "price" => 100, "pricex2" => 200],
22 => ["id" => 2, "name" => "product 2", "price" => 200, "pricex2" => 400],
31 => ["id" => 3, "name" => "product 3", "price" => 300, "pricex2" => 600]
]
*/
```
#### groupBy($key | function($item))
```php
$products = [
["id" => 16, "category_id" => 1, "name" => "product 1", "price" => 100],
["id" => 22, "category_id" => 2, "name" => "product 2", "price" => 200],
["id" => 31, "category_id" => 2, "name" => "product 3", "price" => 300]
];
$collection = PhpCollection:collect($products)->groupBy("category_id")->all();
/*
[
1 => [
["id" => 16, "category_id" => 1, "name" => "product 1", "price" => 100]
],
2 => [
["id" => 22, "category_id" => 2, "name" => "product 2", "price" => 200],
["id" => 31, "category_id" => 2, "name" => "product 3", "price" => 300]
]
]
*/
```
#### find(function($item))
#### some($value | function($item)) OR contains($value | function($item))
#### every(function($item))
#### sort(function($item))
#### sortBy($key, $asc = true)
#### values()
#### first()
#### last()
#### count()
#### all() OR toArray()
#### toJson()
#### zip()
## TODO
#### dumpBrowser()
#### dump()
#### toCsv()
#### toXml()
#### shuffle()
#### random()
#### chunk()
#### unique("" | $key | function($item))
#### collapse()
#### diff($array)
#### has($key)
#### flip()
#### min("" | $key | function($item))
#### max("" | $key | function($item))
#### reduce($function)