eden/collection

Eden generic collection component

4.0.1 2015-10-13 05:27 UTC

Requires

• php: >=5.4.1
• eden/array: 4.*
• eden/core: 4.*
• eden/model: 4.*
• eden/string: 4.*

MIT

• Christian Blanquera

• library
• eden

README

• Install
• Introduction
• Contributing

====

Install

composer install eden/collection

====

Introduction

Manipulating table, matrix or multidimensional data in most cases can be expressed as a collection. Collections in Eden is defined loosely and as a utility class to help managing data in a controlled and chainable format. The basic setup of a collection is described in Figure 1.

Figure 1. Setup

$users = array(
	array(
		'user_name' => 'Chris',
		'user_email' => '[e-mail]',
		'user_location' => 'Manila, Philippines'
	),
	
	array(
		'user_name' => 'Dan',
		'user_email' => '[e-mail]',
		'user_location' => 'Manila, Philippines'
	),
);

eden('collection', $users);

Collections do exactly the same thing as models except it manipulates multiple models instead. Collections can be iterable and access as arrays as well. Collections only hold model objects so if you wanted to use your own extended model, you would need to call ->setModel('Your_Model'). From here we can access properties in our collection as a method, property or back as an array. Figure 2 shows the ways to access data in action.

**Figure 2. Accessing Collection, Models and Rows **

//set user name for all rows
$collection->setUserName('Chris');

// set or get any abstract key for all rows
$collection->setAnyThing();

//collections are iterable
foreach($collection as $model) {        
	echo $model->getUserName().' ';
	echo $model['user_email'];
}
 
//access as array
echo $collection[0]['user_name'];
//set as array
$collection[0]['user_email'] = '[e-mail]'; 

Some other utility methods not covered by th above examples are date formating and copying from one column to another. Figure 3, show how we would go about doing these things.

Figure 3. Utility methods

//for each row, copy the value of post_user to the user_id column
$collection->copy('post_user', 'user_id');

//remove the row with the index of 1, reindexes all the rows
$collection->cut(1);

//returns the number of rows
$collection->count();

//adds a new row
$collection->add(array('post_title' => 'Hi'));

//returns a table array (no objects)
$collection->get();   

====

#Contributing to Eden

Contributions to Eden are following the Github work flow. Please read up before contributing.

##Setting up your machine with the Eden repository and your fork

1. Fork the repository
2. Fire up your local terminal create a new branch from the v4 branch of your fork with a branch name describing what your changes are. Possible branch name types:
   • bugfix
   • feature
   • improvement
3. Make your changes. Always make sure to sign-off (-s) on all commits made (git commit -s -m "Commit message")

##Making pull requests

1. Please ensure to run phpunit before making a pull request.
2. Push your code to your remote forked version.
3. Go back to your forked version on GitHub and submit a pull request.
4. An Eden developer will review your code and merge it in when it has been classified as suitable.