pragmarx/coollection

Laravel Illuminate collection with objectified properties

Coollection

, _(*1)

, _(*2)

Access collection items as objects properties

Coollection is Laravel's Illuminate\Collection repackaged to be used as all properties were objects:, _(*3)

``` php $collection->name, <sub>(*4)</sub>

$collection->addresses->first()->street_name, <sub>(*5)</sub>

$collection->flatten()->cars->filter(function($car) { return $car->name == 'ferrari' })->last()->model, <sub>(*6)</sub>

$countries->where('name.common', 'United States')->first()->currency->name->english;, <sub>(*7)</sub>

#### Tightenco\Collect

To be agnostic and have complete idependence from Laravel's, but also to allow it to be used in Laravel applications, this package extends [Tightenco\Collect](https://github.com/tightenco/collect), developed by [Matt Stauffer](https://twitter.com/stauffermatt) from [Tighten](https://twitter.com/tightenco). 

## Why?

#### Answering with a question: which one is easier to look at?

``` php
collect(
    collect(
        collect(
            collect(
                $collection['cars']
            )->unique('constructor')['models']
        )->last()['model']
    )['colors']
)->first()['rgb']

or, <sub>(*8)</sub>

``` php $collection->cars->unique('constructor')->last()->model->colors->first()->rgb, <sub>(*9)</sub>

#### Isn't this easier on the eyes?

``` php
collect($vimeo)->body->data->first()->metadata->connections->likes->total;

Or you prefer this one?, <sub>(*10)</sub>

``` php collect($vimeo)['body']['data'][0]['metadata']['connections']['likes']['total'];, <sub>(*11)</sub>

#### Used with Laravel request it is useful, if you receive:

``` json
{"pagination":{"perPage":100,"pageNumber":1}}

You collect() it:, <sub>(*12)</sub>

``` php $input = coollect($request->all());, <sub>(*13)</sub>

And you can just:

``` php
$input->pagination->perPage

Instead of:, <sub>(*14)</sub>

``` php $input->get('pagination')['perPage'], <sub>(*15)</sub>

You can also use "dot notation" to get your items:

``` php
$input->get('pagination.perPage')

PHP Agnostic

This is an agnostic PHP package, an extraction of Illuminate\Support\Collection with all needed classes, interfaces and traits. For that if you wish just to use Illuminate's Collection, you just have to import the class Collection:, <sub>(*16)</sub>

``` php $collection = new IlluminateExtracted\Support\Collection(['my collection']);, <sub>(*17)</sub>

or use the usual helper:

``` php
$collection = collect(['my collection']); 

Documentation

It's Laravel's Collection, at full power, so you can check its docs. The only difference is that you can access items (array keys) as properties, like any other PHP object:, <sub>(*18)</sub>

``` php $collection->map($mapper)->reduce($reducer)->random()->address->street, <sub>(*19)</sub>

$this->sendThanks( $collection->where('full_name', 'Barack Obama')->addresses->random() );, <sub>(*20)</sub>

$countries->where('name.common', 'United States')->first()->currency->symbol;, <sub>(*21)</sub>

## Install

Via Composer

``` bash
$ composer require pragmarx/coollection

Usage

Instantiate, the class directly or using the helper:, <sub>(*22)</sub>

``` php $c = new Coollection(['first_name' => 'Barack Obama']);, <sub>(*23)</sub>

$c = coollect(['first_name' => 'Barack Obama']);, <sub>(*24)</sub>

Then you use it as an object:

``` php
echo $c->first_name;

// Barack Obama


echo $c->flip()->barak_obama == 'first_name' 
    ? 'true' 
    : 'false';

// true

One word keys are case insensitive:, <sub>(*25)</sub>

``` php echo $c->rio; echo $c->RIO;, <sub>(*26)</sub>

## Change log

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

## Testing

``` bash
$ composer test

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details., <sub>(*27)</sub>

Security

If you discover any security related issues, please email acr@antoniocarlosribeiro.com instead of using the issue tracker., <sub>(*28)</sub>

Credits

• This package is an extension of Tightenco\Collect, developed by Matt Stauffer from Tighten.
• Tightenco\Collect is an extraction of The Laravel Framework's Collection, created by Taylor Otwell.
• Package creator Antonio Carlos Ribeiro
• Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*29)</sub>