PHPackages                             mediagone/types-collections - 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. mediagone/types-collections

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

mediagone/types-collections
===========================

Provides full-featured collections for primitive types, and generic classes to build your own strongly-typed collections. Each collection has chainable methods to perform traversal, filter and projection operations (similar to Microsoft's LINQ-like features).

0.1.7(2y ago)12.2k↓50%1MITPHPPHP ^7.4|^8.0

Since May 8Pushed 2y ago1 watchersCompare

[ Source](https://github.com/Mediagone/types-collections)[ Packagist](https://packagist.org/packages/mediagone/types-collections)[ RSS](/packages/mediagone-types-collections/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (9)Used By (0)

Types Collections
=================

[](#types-collections)

[![Latest Version on Packagist](https://camo.githubusercontent.com/f9d3181ffb9028867ff7ca80a369bece9522293f619222d75b07bd6f35964d46/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d65646961676f6e652f74797065732d636f6c6c656374696f6e732e737667)](https://packagist.org/packages/mediagone/types-collections)[![Total Downloads](https://camo.githubusercontent.com/23623a68413d61d1fe5b3cb67f6e2430c34e8153fda4b5a0ddb8da5db1fe6463/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d65646961676f6e652f74797065732d636f6c6c656374696f6e732e737667)](https://packagist.org/packages/mediagone/types-collections)[![Software License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](LICENSE)

This package provides **full-featured collections** for primitive types, and generic classes to build your own strongly-typed collections. Each collection has chainable methods to perform traversal, filter and projection operations.

Example:

```
IntCollection::fromArray([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])
    ->where(fn($n) => $n > 4)
    ->append(10)
    ->select(static fn($n) => $n * 10)
    ->forEach(static fn(int $n) => var_dump($n));

// Outputs:
//   int(50)
//   int(60)
//   int(70)
//   int(80)
//   int(90)
//   int(100)
```

Chapters:

1. Available collections
    - [Primitive-type collections](#primitive-collections)
    - [Class collections](#class-collections)
2. Basic usage
    - [Constructors](#usage-constructors)
    - [Modifying the collection](#usage-modifying)

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

[](#installation)

This package requires **PHP 7.4+**

Add it as Composer dependency:

```
$ composer require mediagone/types-collections
```

1. Available collections
------------------------

[](#1-available-collections)

### Primitive-type collections

[](#primitive-type-collections)

The `Mediagone\Types\Collections\Types` namespace provides strongly-typed collections for all PHP's primitive types:

- `ArrayCollection`: *a strongly-typed collection that can only contain PHP **array** values.*
- `BoolCollection`: *a strongly-typed collection that can only contain PHP **boolean** values.*
- `CallableCollection`: *a strongly-typed collection that can only contain PHP **callable** values.*
- `FloatCollection`: *a strongly-typed collection that can only contain PHP **float** values.*
- `IntCollection`: *a strongly-typed collection that can only contain PHP **integer** values.*
- `MixedCollection`: *a strongly-typed collection that can only contain PHP **mixed** values.*
- `ObjectCollection`: *a strongly-typed collection that can only contain PHP **object** values.*
- `ResourceCollection`: *a strongly-typed collection that can only contain PHP **resource** values.*
- `StringCollection`: *a strongly-typed collection that can only contain PHP **string** values.*

### Class collections

[](#class-collections)

The library also provides an abstract class to build strongly-typed class collections easily.

Start by creating a class that extends `Mediagone\Types\Collections\Types\ClassCollection` and implements the `classFqcn` method:

```
use App\Foo;
use Mediagone\Types\Collections\ClassCollection;

class FooCollection extends ClassCollection
{
    protected static function classFqcn() : string
    {
        return Foo::class;
    }
}
```

If you're using a static analyser tool, you must specify the type for the generic base collection with this simple annotation:

```
/*
 * @extends ClassCollection
 */
class FooCollection extends ClassCollection
{
```

And... that's all! Your custom collection now only accepts Foo instances.

2. Basic usage
--------------

[](#2-basic-usage)

### Constructors

[](#constructors)

#### Empty

[](#empty)

You can create an empty collection using the `new` static factory method:

```
$collection = StringCollection::new();
```

#### From array

[](#from-array)

You can also instantiate any collection with initial data using `fromArray` and items can be retrieved as a PHP array using `toArray` method, for example:

```
$collection = StringCollection::fromArray(['item1', 'item2', '3']);
var_dump($collection->toArray());
// Outputs:
//   array(3) {
//     [0] => string(5) "item1"
//     [1] => string(5) "item2"
//     [2] => string(1) "3"
//   }
```

Typed collections throw an error if invalid items are added to the collection:

```
// Throws a TypeError exception because this collection accepts only integer instances
$collection = IntCollection::fromArray([1, 2, 'invalid item']);
```

#### From repeated value

[](#from-repeated-value)

Collection can also be created with initial repeated value `fromRepeatedValue`:

```
$collection = StringCollection::fromRepeatedValue('something', 3);
var_dump($collection->toArray());
// Outputs:
//   array(3) {
//     [0] => string(9) "something"
//     [1] => string(9) "something"
//     [2] => string(9) "something"
//   }
```

#### Additional constructors

[](#additional-constructors)

Some collections implement specific static factory methods related to the underlying type (take a look to each class to discover specific available factories), for example in the `IntCollection` class :

```
$collection = IntCollection::fromRange(2, 5);
var_dump($collection->toArray());
// Outputs:
//   array(5) {
//     [0] => int(2)
//     [1] => int(3)
//     [2] => int(4)
//     [3] => int(5)
//   }
```

### Modifying the collection

[](#modifying-the-collection)

New elements can be added after the collection's initialization using `append` or `prepend` methods:

```
$collection = StringCollection::fromArray(['item1', 'item2']);

// Add a value at the end of the collection
$collection->append('item3');

// Add a value at the start of the collection
$collection->prepend('item0');

var_dump($collection->toArray());
// Outputs:
//   array(4) {
//     [0] => string(5) "item0"
//     [1] => string(5) "item1"
//     [2] => string(5) "item2"
//     [3] => string(5) "item3"
//   }
```

> *Note: item indexes always start at 0, even after inserting, removing or reordering items.*

But, the base collection class offers a lot more useful methods:

- ***Conversion** methods:*

    - `toArray`: Return the collection's items as an array.
    - `toCollection`: Converts the collection into a new collection type, all items must be valid in the target collection.
- ***Element** methods:*

    - `contains`: Determines whether the collection contains a specified item.
    - `append`: Adds an item to the end of the collection.
    - `prepend`: Adds an item to the beginning of the collection.
    - `concat`: Merges a collection into the current collection's items.
    - `remove`: Removes an item from the collection.
    - `first`: Returns the first item of the collection.
    - `firstOrNull`: Returns the first item of the collection (that satisfies the optional condition) or null if no such item is found.
    - `firstOrDefault`: Returns the first item of the collection (that satisfies the optional condition) or a default value if no such item is found.
    - `last`: Returns the last item of the collection.
    - `lastOrNull`: Returns the last item of the collection (that satisfies the optional condition) or null if no such item is found.
    - `lastOrDefault`: Returns the last item of the collection (that satisfies the optional condition) or a default value if no such item is found.
    - `single`: Returns the only item of the collection or throws an exception if more than one item exists.
    - `singleOrDefault`: Returns the only item of the collection or throws an exception if more than one item exists.
    - `random`: Returns the only item of the collection or throws an exception if more than one item exists.
- ***Partitioning** methods:*

    - `skip`: Bypasses a specified number of items in the collection and then returns the remaining items.
    - `skipLast`: Returns a new collection that contains the items from source with the last count items of the source collection omitted.
    - `skipWhile`: Bypasses items in the collection as long as a specified condition is true and then returns the remaining items.
    - `take`: Returns a specified number of contiguous items from the start of the collection.
    - `takeLast`: Returns a new collection that contains the last count items from source.
    - `takeWhile`: Returns items from the collection as long as a specified condition is true.
    - `distinct`: Removes duplicated items from the collection.
    - `distinctBy`: Removes duplicated items from the collection according to a specified key selector function.
    - `where`: Filters the collection items based on a predicate.
    - `except`: Computes the difference of collections.
    - `exceptBy`: Computes the set difference of two sequences according to a specified key selector function.
    - `intersect`: Computes the set intersection of two collections.
    - `intersectBy`: Computes the set difference of two sequences according to a specified key selector function.
- ***Ordering** methods:*

    - `shuffle`: Randomizes the order of the items in the collection.
    - `reverse`: Inverts the order of the items in the collection.
    - `sort`: Sorts the items of the collection in ascending order according to a key.
    - `sortDescending`: Sorts the items of the collection in descending order according to a key.
    - `sortBy`: Sorts the items of the collection in ascending order according to a key.
    - `sortByDescending`: Sorts the items of the collection in descending order according to a key.
- ***Aggregation** methods:*

    - `count`: Returns the number of items in the collection.
    - `min`: Returns the minimum value of the collection.
    - `max`: Returns the maximum value of the collection.
    - `average`: Computes the average of the collection values.
    - `sum`: Computes the sum of the collection of numeric values.
    - `aggregate`: Applies an accumulator function over a sequence.
- ***Projection** methods:*

    - `chunk`: Splits the items of the collection into chunks of specified size.
    - `select`: Projects each item of the collection into a new form and returns an array that contains the transformed items of the collection.
    - `selectMany`: Projects each item of the collection to a collection and flattens the resulting collections into one collection.
    - `groupBy`: Groups the items of the collection according to a specified key selector function.
    - `join`: Correlates the items of two collection based on matching keys.
- ***Quantifier** methods:*

    - `all`: Determines whether all items of the collection satisfy a condition.
    - `any`: Determines whether the collection contains any items.
- ***Traversal** methods:*

    - `forEach`: Applies a callback function to each item of the collection.

> *Note: all collections implement the `JsonSerialize` and `ArrayIterator` interfaces. Collections also implement `ArrayAccess` to allow items to be accessed through the standard array syntax `$collection[$i]`, however **items can only be accessed** but **not set or unset**.*

License
-------

[](#license)

*Types Collections* is licensed under MIT license. See LICENSE file.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~2 days

Total

8

Last Release

1093d ago

### Community

Maintainers

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

---

Top Contributors

[![Mediagone](https://avatars.githubusercontent.com/u/32240357?v=4)](https://github.com/Mediagone "Mediagone (82 commits)")

---

Tags

clean-codecollectionsgenericlinqstrongly-typedtypetypecollectionsvalue objectslinq

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/mediagone-types-collections/health.svg)

```
[![Health](https://phpackages.com/badges/mediagone-types-collections/health.svg)](https://phpackages.com/packages/mediagone-types-collections)
```

###  Alternatives

[doctrine/collections

PHP Doctrine Collections library that adds additional functionality on top of PHP arrays.

6.0k411.1M1.2k](/packages/doctrine-collections)[phpoption/phpoption

Option Type for PHP

2.7k541.2M159](/packages/phpoption-phpoption)[jetbrains/phpstorm-stubs

PHP runtime & extensions header files for PhpStorm

1.4k27.7M68](/packages/jetbrains-phpstorm-stubs)[marc-mabe/php-enum

Simple and fast implementation of enumerations with native PHP

49644.8M97](/packages/marc-mabe-php-enum)[symfony/type-info

Extracts PHP types information.

19951.9M114](/packages/symfony-type-info)[dusank/knapsack

Collection library for PHP

5351.0M25](/packages/dusank-knapsack)

PHPackages © 2026

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