A (memory) friendly, easy, lazy and modular collection class.
This package is auto-updated.
Last update: 2020-08-10 20:23:11 UTC
Collection is a functional utility library for PHP greater than 7.1.3.
It's similar to other collection libraries based on regular PHP arrays, but with a lazy mechanism under the hood that strives to do as little work as possible while being as flexible as possible.
array_reduce() are great, but they create new arrays and everything is eagerly done before
going to the next step.
Lazy collection leverages PHP's generators, iterators and yield statements to allow you to work with very large data
sets while keeping memory usage as low as possible.
For example, imagine your application needs to process a multi-gigabyte log file while taking advantage of this library's methods to parse the file. Instead of reading and storing the entire file into memory at once, this library may be used to keep only a small part of the file in memory at a given time.
On top of this, this library:
- is immutable,
- is extendable,
- leverages the power of PHP generators and iterators,
- uses S.O.L.I.D. principles,
- does not have any external dependency,
- fully tested,
- type safe (type safe @ > 98%),
- framework agnostic.
Also, unlike regular PHP arrays where keys must be either of type
string, this collection library let you use
any kind of type for keys: integer, string, objects, arrays, ... anything!
This library could be a valid replacement for \SplObjectStorage but with much more features.
This way of working opens up new perspectives and another way of handling data, in a more functional way.
And last but not least, collection keys are preserved throughout most operations, and it might be leading to some confusions, carefully read this example for the full explanation.
This library has been inspired by:
- Laravel Support Package
- Ruby Array
composer require loophp/collection
On top of a complete documented code, the package include a full documentation that gets automatically compiled and published upon each commit at https://loophp-collection.rtfd.io.
The API will give you a pretty good idea of the existing methods and what you can do with it.
I'm doing my best to keep the documentation up to date, if you found something odd, please let me know in the issue queue.
Every time changes are introduced into the library, Github run the tests.
The library has tests written with PHPSpec.
Feel free to check them out in the
spec directory. Run
composer phpspec to trigger the tests.
Before each commit some inspections (currently 14) are executed with GrumPHP,
composer grumphp to check manually.
The quality of the tests is tested with Infection a PHP Mutation testing
composer infection to try it.
Feel free to contribute by sending Github pull requests. I'm quite reactive :-)