werxe/laravel-collection-macros

Laravel Collection Macros

Custom Laravel Collection Macros for Laravel 9.

This package is compliant with the FIG standards PSR-1, PSR-2 and PSR-4 to ensure a high level of interoperability between shared PHP. If you notice any compliance oversights, please send a patch via pull request.

Version Matrix

Getting Started

Install the package via Composer by running:

composer require werxe/laravel-collection-macros

By default all macros are enabled and the macro name is the lower cased version of the macro class.

If you want to customize which macros are enabled or just rename the macro name, you can do so by publishing the configuration file, by running:

php artisan vendor:publish --tag="werxe:collection-macros.config"

The configuration file is now published at config/werxe/collection-macros/config.php.

Documentation

Available Macros

• increment
• decrement
• ksort
• krsort
• recursive

increment

Increment a value that's inside a Collection

$collection = collect([
    'total' => 1,
]);

$collection->increment('total', 2); // 3

decrement

Decrement a value that's inside a Collection

$collection = collect([
    'total' => 3,
]);

$collection->decrement('total', 2); // 1

ksort

Sorts the Collection by its keys.

$collection = collect(['d' => 'lemon', 'a' => 'orange', 'b' => 'banana', 'c' => 'apple']);

$collection->ksort(); // ['a' => 'orange', 'b' => 'banana', 'c' => 'apple', 'd' => 'lemon']

krsort

Sorts the Collection by its keys in the reverse order

$collection = collect(['d' => 'lemon', 'a' => 'orange', 'b' => 'banana', 'c' => 'apple']);

$collection->krsort(); // ['d' => 'lemon', 'c' => 'apple', 'b' => 'banana', 'a' => 'orange']

recursive

Recursively convert nested arrays into Laravel Collections.

$collection = collect([
    'name' => 'John Doe',
    'emails' => [
        'john@doe.com',
        'john.doe@example.com',
    ],
    'contacts' => [
        [
            'name' => 'Richard Tea',
            'emails' => [
                'richard.tea@example.com',
            ],
        ],
    ],
]);

// Convert the nested arrays into Collections
$convertedCollection = $collection->recursive();

// Get the contacts as a Collection
$contacts = $convertedCollection->get('contacts');

Contributing

Thank you for your interest in Laravel Collection Macros. Here are some of the many ways to contribute.

• Check out our contributing guide
• Look at our code of conduct

Security

If you discover any security related issues, please email security@werxe.com instead of using the issue tracker.

License

Laravel Collection Macros is licenced under the MIT License (MIT). Please see the license file for more information.