chipslays/collection

Collection 📁

Laravel-style collections for any PHP project — with dot-notation paths in every method.

Why Collection

• Paths everywhere. get, set, where, sortBy, groupBy, sum, pluck and dozens of other methods accept paths like user.address.city, users.*.email, users[?active].email or **.email. Paths go through arrays, objects and nested collections — and stay close to hand-written loops in speed.
• Reshape data in one call. rename() and remap() move fields into the structure you need; cast() converts types with built-in casters, enums, classes, callbacks or your own Caster.
• The Laravel API you already know. Every method of Illuminate\Support\Collection, with the same names and behaviour — but no framework required. What is different 🤔
• You stay in control. Methods that wrap PHP functions expose their options: SORT_* flags, JSON flags and depth, preserveKeys, a seeded Random\Randomizer, rounding modes.
• No surprises. Transforming methods return a new collection; the few that change data in place are clearly listed. Strings are never called as functions by accident.
• Zero dependencies. PHP 8.4+, one package, fully tested and statically analysed.

Installation

composer require collection/collection

use Collection\Collection;

$c = new Collection($array);
$c = Collection::make($arrayOrJsonOrIterable);
$c = collection($array); // global helper

Documentation

All methods at a glance 👉

Contributing

composer test # Pest
composer analyse # PHPStan

Issues and pull requests are welcome!

License

MIT — see LICENSE.md.