bapcat/collection

Powerful but easy to use collections with support for lazy loading

, _(*1)

Collection

A modular, trait-based collection library that puts control of your data back in your hands., _(*2)

Installation

Composer

Composer is the recommended method of installation for Collection., _(*3)

$ composer require bapcat/collection

GitHub

This package may also be downloaded from GitHub., _(*4)

Features

Basic Collection Use

Collections make it easy to control access to your data in an object-oriented way. The standard implementation supports reading and writing, as well as standard foreach iteration., _(*5)

$collection = new Collection(['k1' => 'v1']);

var_dump($collection->get('k1')); // 'v1'
var_dump($collection->size()); // 1

$collection->set('k2', 'v2');

$collection->add('v3');

// $collection == ['k1' => 'v1', 'k2' => 'v2', 'v3']

$collection->remove('k2');

// $collection == ['k1' => 'v1', 'v3']

foreach($collection as $k => $v) {
    //
}

Custom Collections

Collections are built with traits, so it's easy to pick-and-choose the features you want. For example, you may want a collection that can't be modified from the outside:, _(*6)

class MyCollection implements ReadableCollectionInterface {
    use ReadableCollectionTrait;

    protected $collection = [];
}

If you would like to implement a full read/write collection, you may extend the basic Collection class:, _(*7)

class MyCollection extends Collection {
    //
}

Or, you may implement the interfaces and trait:, _(*8)

class MyCollection implements ReadableCollectionInterface, WritableCollectionInterface {
    use ReadableCollectionTrait, WritableCollectionTrait;
}

Array Access

If you would like to use array access with your collection, use the ArrayAccessCollection class or the ArrayAccessCollectionTrait trait., _(*9)

Lazy Loading

Writable collections have support for lazy-loading built in. Lazy loading can be very useful, for example, in database interactions., _(*10)

$collection->lazy(1, function($key) {
    return User::find($key);
});