yiisoft/yii2-collection

Active Record Collection implementation for the Yii framework

dev-master / 1.0.x-dev 2024-01-31 08:51 UTC

Requires

• php: >=5.6.0
• yiisoft/yii2: ~2.0.14

Requires (Dev)

• phpunit/phpunit: <7

BSD-3-Clause

• Carsten Brandt

• collection
• active-record
• yii2

README

ActiveRecord Collection Extension for Yii 2

This extension provides a generic data collection as well as a collection for the ActiveRecord DB layer of Yii 2.

Development is currently in experimental state. It is not ready for production use and may change significantly.

For license information check the LICENSE-file.

Documentation is at docs/guide/README.md.

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist yiisoft/yii2-collection

or add

"yiisoft/yii2-collection": "~1.0.0"

to the require section of your composer.json.

Configuration

To use this extension, you have to attach the yii\collection\CollectionBehavior to the ActiveQuery instance of your ActiveRecord classes by overriding the find() method:

/**
 * {@inheritdoc}
 * @return \yii\db\ActiveQuery|\yii\collection\CollectionBehavior
 */
public static function find()
{
    $query = parent::find();
    $query->attachBehavior('collection', \yii\collection\CollectionBehavior::class);
    return $query;
}