This Collection library is an OOP replacement for the traditional array data structure. Much like an array, a collection contains member elements, although these tend to be objects rather than simpler types such as strings and integers.
This library is developed and maintained by myself for various personal projects where I don't want to rely on third-party collection packages for licensing reasons or maintainability etc.
This library is developed and tested for PHP 5.3+
This library is unit tested against PHP 5.3, 5.4, 5.5, 5.6, HHVM and 7.0!
This client library is released under the MIT license, a copy of the license is provided in this package.
To install the package into your project (assuming you are using the Composer package manager) you can simply execute the following command from your terminal in the root of your project folder:
composer require ballen/collection
Alternatively you can manually add this library to your project using the following steps, simply edit your project's composer.json file and add the following lines (or update your existing require section with the library like so):
"require": {
"ballen/collection": "^1.0"
}Then install the package like so:
composer update ballen/collection --no-dev
A simple example of adding, sorting and iterating data in a collection.
<?php
use Ballen\Collection\Collection;
This library is fully unit tested using PHPUnit.
I use TravisCI for continuous integration, which triggers tests for PHP 5.3, 5.4, 5.5, 5.6, 7.0 and HHVM every time a commit is pushed.
If you wish to run the tests yourself you should run the following:
# Install the Collection Library with the 'development' packages this then includes PHPUnit!
composer install --dev
# Now we run the unit tests (from the root of the project) like so:
./vendor/bin/phpunitCode coverage can also be ran but requires XDebug installed...
./vendor/bin/phpunit --coverage-html ./reportI am happy to provide support via. my personal email address, so if you need a hand drop me an email at: ballen@bobbyallen.me.