README

简单的对象集合。

安装

最好使用 Composer 进行安装。

$ composer require bittyphp/collection

可读集合

可读集合必须实现 Bitty\Collection\ReadableCollectionInterface。该接口只提供非常基本的方法：has()、get() 和 all()。

基本用法

<?php

use Bitty\Collection\ReadableArrayCollection;

$collection = new ReadableArrayCollection(
    [
        'foo' => 'bar',
        'baz' => ['blar', 'blah', 'blam'],
    ]
);

// Check if data exists.
if ($collection->has('foo')) {
    // Do something.
}

// Get data, or get a default value if it doesn't exist.
$default = 'not set';
$value = $collection->get('foo', $default);

// Get all the data.
$data = $collection->all();

可写集合

可写集合必须实现 Bitty\Collection\WritableCollectionInterface。该接口扩展了 Bitty\Collection\ReadableCollectionInterface 并添加了一个额外的 set() 方法。

基本用法

<?php

use Bitty\Collection\WritableArrayCollection;

$collection = new WritableArrayCollection(
    [
        'foo' => 'bar',
        'baz' => ['blar', 'blah', 'blam'],
    ]
);

// Add new data to the collection.
$collection->set('key', 'value');

可移除集合

可移除集合必须实现 Bitty\Collection\RemovableCollectionInterface。该接口扩展了 Bitty\Collection\WritableCollectionInterface 并添加了额外的 remove() 和 clear() 方法。

基本用法

<?php

use Bitty\Collection\RemovableArrayCollection;

$collection = new RemovableArrayCollection(
    [
        'foo' => 'bar',
        'baz' => ['blar', 'blah', 'blam'],
    ]
);

// Remove one item.
$collection->remove('foo');

// Clear all the data.
$collection->clear();