PHPackages                             pion/laravel-support-collection - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. pion/laravel-support-collection

ActiveLibrary[Utility & Helpers](/categories/utility)

pion/laravel-support-collection
===============================

The support classes for the Laravels collection

v1.1.4(1mo ago)07.0k↑60%1MITPHPPHP ^8.0

Since Jun 18Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/pionl/laravel-support-collection)[ Packagist](https://packagist.org/packages/pion/laravel-support-collection)[ Fund](https://revolut.me/martinpv7n)[ GitHub Sponsors](https://github.com/pionl)[ RSS](/packages/pion-laravel-support-collection/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (5)Dependencies (3)Versions (7)Used By (0)

Laravel Collection support package
==================================

[](#laravel-collection-support-package)

A mix of classes for improving the Collection.

Installation
------------

[](#installation)

```
composer require pion/laravel-support-collection

```

NestedObjectCollection
----------------------

[](#nestedobjectcollection)

Creates a nested collection from flat collection to child nested collection based on parent property and id property.

It's expected that the values are **objects**, it will insert the childs into the desired property.

All childs are stored to childs property in the object. Can be empty.

You can call all Collection methods on the NestedObjectCollection object, all method calls are passed into the collection

### Construct

[](#construct)

Groups the items by the parent property and loops from the top of tree (null property or different value) and adds childs to the object.

*Parameters*

- Collection `$items`
- string `$parentProperty` the property name to get the parent id
- string `$idProperty` the property name to get the id value
- string `$rootIndexKeyOnGroup` the index key for getting the root elements. When the parent property value returns null, it will be empty string.
- string `$propertyForChildren` the property name to store the children

    public function \_\_construct(Collection $items, $parentProperty = "parent\_id", $idProperty = "id", $rootIndexKeyOnGroup = "", $propertyForChildren = "childs")

### Eloquent usage

[](#eloquent-usage)

It's advised to set a property in the Eloquent model to prevent creating childs into the attributes. For default property name you can use the `ChildsCollectionTrait`. This provides a public `$childs` property for your Eloquent model

### Example

[](#example)

```
$object1 = new stdClass();
$object1->id = 1;

// this is the root!
$object1->parent_id = null;

$object2 = new stdClass();

$object2->id = 2;
$object2->parent_id = 2;

$object3 = new stdClass();

$object3->id = 3;
$object3->parent_id = 1;

$example = new \Pion\Support\Collection\NestedObjectCollection(new \Illuminate\Support\Collection([
    $object1, $object2, $object3
]));

$collection = $example->getCollection();

```

This example will create a collection of single item (the `$object1`). This objects will have a new property $childs which is holding a Collection of single item `$object2` that holds again property $childs with a single item `$object3`

GroupedCollection
-----------------

[](#groupedcollection)

Enables a quick how to build a grouped collection. Just add a new item to the collection with given group key and the value. Optionally you can provide also the key for the value.

```
public function add($groupKey, $value, $key = null)

```

### Example

[](#example-1)

The use of the collection is same as standard collection.

```
$groupedCollection = new GroupedCollection();
$groupedCollection->add("1", "test 1");
$groupedCollection->add("1", "test 2");
$groupedCollection->add("1", "test 3");
$groupedCollection->add("2", "test 2-1");
$groupedCollection->add("2", "test 2-2");

```

This will result in a collection of items with a collection object. If you export the collection into array you will grouped array as expected.

```
var_dump($groupedCollection->toArray());

array(2) {
  [1] =>
  array(3) {
    [0] =>
    string(6) "test 1"
    [1] =>
    string(6) "test 2"
    [2] =>
    string(6) "test 3"
  }
  [2] =>
  array(2) {
    [0] =>
    string(8) "test 2-1"
    [1] =>
    string(8) "test 2-2"
  }
}

```

Testing
-------

[](#testing)

Run the full support matrix and get a pass/fail table:

```
bin/test-matrix.sh
```

Run the PHPUnit suite in Docker for each supported PHP runtime:

```
docker compose run --rm php82 composer test
docker compose run --rm php83 composer test
docker compose run --rm php85 composer test
```

Resolve and test a specific Laravel support line inside Docker:

```
docker compose run --rm php82 bin/test-target.sh '^9.0'
docker compose run --rm php82 bin/test-target.sh '^10.0'
docker compose run --rm php83 bin/test-target.sh '^11.0'
docker compose run --rm php83 bin/test-target.sh '^12.0'
docker compose run --rm php85 bin/test-target.sh '^13.0'
```

###  Health Score

54

—

FairBetter than 97% of packages

Maintenance91

Actively maintained with recent releases

Popularity24

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity72

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~917 days

Total

5

Last Release

44d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ad0f2a11e630f5f386cb8544d42f0c56c2b89258172dae581a33dddcc5de1d83?d=identicon)[pionl](/maintainers/pionl)

---

Top Contributors

[![pionl](https://avatars.githubusercontent.com/u/1878831?v=4)](https://github.com/pionl "pionl (2 commits)")[![cibot-pionl](https://avatars.githubusercontent.com/u/299922687?v=4)](https://github.com/cibot-pionl "cibot-pionl (1 commits)")[![h4kuna](https://avatars.githubusercontent.com/u/335722?v=4)](https://github.com/h4kuna "h4kuna (1 commits)")[![jakubdibala](https://avatars.githubusercontent.com/u/7672104?v=4)](https://github.com/jakubdibala "jakubdibala (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pion-laravel-support-collection/health.svg)

```
[![Health](https://phpackages.com/badges/pion-laravel-support-collection/health.svg)](https://phpackages.com/packages/pion-laravel-support-collection)
```

###  Alternatives

[illuminate/pagination

The Illuminate Pagination package.

12234.6M1.1k](/packages/illuminate-pagination)[illuminate/pipeline

The Illuminate Pipeline package.

9350.2M310](/packages/illuminate-pipeline)[illuminate/redis

The Illuminate Redis package.

8314.8M410](/packages/illuminate-redis)[illuminate/cookie

The Illuminate Cookie package.

224.7M146](/packages/illuminate-cookie)[forjedio/inertia-table

Backend-driven dynamic tables for Laravel + Inertia.js

272.0k](/packages/forjedio-inertia-table)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

265.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)