Collections Abstraction library for PHP
The Collection library is one of the most useful things that many modern languages has, but for some reason PHP doesn't has a built in collection layer.
For that reason we created Collections, an incredible library that gathers the best of .NET's and Java's collections patterns and unify it with PHP array power.
Take a look and see what we're talking about!!
{
"require": {
"easyframework/collections": "~3.1"
}
}The Collection represents the List in .NET language or simply non-associative arrays in php:
$collection = new \Easy\Collections\ArrayList();
$collection->add('John');
$collection->add('Maria');
$collection->add('Anderson');
$collection->map(function($item){
echo $item;
});Lets continue with the exemple above and count how many elements we have!
echo $colletion->count();Great, now we know how to run through a collection and how to count it, but these are pretty simple things to do, so lets sort them:
$collection->sort(); //by default the sort is by the keys
$colletion->sort(new \Easy\Collections\Comparer\StringComparer()); //this will sort by alfabetic order
$collection->sort(new YourCustomComparer()); //you can create your own custom comparer to sort your collectionYeah that is great, isn't it? But we can do much more things, now lets search for someone in the collection.
print_r($collection->contains("John")); //returns trueOk now we learned many things of collections, we can do even more, but I'll show you other type of collection called Dictionary.
The Dictionary class is something like associative arrays in PHP, or Hash tables in other languages.
$dictionary = new \Easy\Collections\Dictionary();
$dictionary->add('person1', array(
'name' => 'John',
'age' => 20
));
$dictionary->add('person2', array(
'name' => 'Maria',
'age' => 19
));
$dictionary->add('person3', array(
'name' => 'Anderson',
'age' => 25
));
$collection->map(function($item){
echo $key . ": " . $item['name'] . "-" . $item['age'];
});
We can use object as keys too.
$dictionary = new \Easy\Collections\Dictionary();
$object = new \stdClass();
$dictionary->add($object, 'value');
echo $dictionary->get($object); //prints 'value'When one key is inserted we can't insert the same key again, if we want to change its value we need to use the method set() Here is an example of how we can get some item based on the key;
print_r ($dictionary->get('person1')); //returns array('name' => John, 'age' => 20)All Collection methods are also avaliable in Dictionary class, just remember to use each one in correct case, this will help you keep organization in your project.
To our last exemple we'll use objects in our collection.
$collection = new \Easy\Collections\ArrayList();
$collection->add(new Person('John', 20));
$collection->add(new Person('Peter', 20));
$collection->add(new Person('Sophie', 21));
$collection->add(new Person('Angela', 29));
$collection->add(new Person('Maria', 19));
$collection->add(new Person('Anderson', 25));
$collection->map(function($item){
echo $item->getName();
});Pretty simple, but the reason I wanted to show you objects is because of Expression search, something like Linq for .NET Lets seek everyone with age 20.
$criteria = new \Easy\Collections\Criteria();
$expr = $criteria->createExpression()->eq("age", 20);
$criteria->where($expr);
$collection = $collection->matching($criteria);
//only going to list John and Peter wich has 20 years
$collection->map(function($item){
echo $item->getName() . "-" . $item->getAge();
});Now we want everyone where the name starts with 'A'
$criteria = new \Easy\Collections\Criteria();
$expr = $criteria->createExpression()->contains("name", "A");
$criteria->where($expr);
$collection = $collection->matching($criteria);
$collection->map(function($item){
echo $item->getName() . "-" . $item->getAge();
});Let's filter a collection with regex which will filter a string where starts with letter A and ends with letter A.
$criteria = new \Easy\Collections\Criteria();
$expr = $criteria->createExpression()->regex("name", "#^a.+a$#i");
$criteria->where($expr);
$collection = $collection->matching($criteria);
//only going to list Angela
$collection->map(function($item){
echo $item->getName() . "-" . $item->getAge();
});$ phpunitPlease see CONTRIBUTING for details.
The MIT License (MIT). Please see License File for more information.