ballen/collection

A Collection library which provides OOP replacement for the traditional array data structure.

2.0.3 2022-12-25 00:20 UTC

This package is auto-updated.

Last update: 2024-10-25 04:05:23 UTC


README

Build Code Coverage Scrutinizer Code Quality Code Climate Latest Stable Version Latest Unstable Version License

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.

Requirements

This library is developed and tested for PHP 7.3+

This library is unit tested against PHP 7.3, 7.4, 8.0, 8.1 and 8.2!

If you need to use an older version of PHP, you should instead install the 1.x version of this library (see below for details).

License

This client library is released under the MIT license, a copy of the license is provided in this package.

Setup

To install the latest version of this 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

If you need to use an older version of PHP, version 1.x.x supports PHP 5.6, 7.0, 7.1 and 7.2, you can install this version using Composer with this command instead:

composer require ballen/collection ^1.0

Usage

A simple example of adding, sorting and iterating data in a collection.

<?php

use Ballen\Collection\Collection;

Tests and coverage

This library is fully unit tested using PHPUnit.

I use GitHub Actions for continuous integration, which triggers unit tests each time a commit is pushed.

If you wish to run the tests yourself you should run the following:

# Install the Collection Library
composer install


# Now we run the unit tests (from the root of the project) like so:
./vendor/bin/phpunit

Code coverage can also be run but requires XDebug installed...

./vendor/bin/phpunit --coverage-html ./report

Support

I am happy to provide support via. my personal email address, so if you need a hand drop me an email at: ballen@bobbyallen.me.