ngtfkx/laradeck-collection-macros

A set of useful Laravel collection macros

laradeck-collection-macros

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads], _(*1)

Набор макросов для расширения стандартного функционала Illuminate\Support\Collection, _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require ngtfkx/laradeck-collection-macros, <sub>(*4)</sub>

## Documentation

**forSelect(string $valueName, string $keyName = 'id'): array**

Метод возвращает ассоциативный массив, где в качестве ключа используется свойство `$keyName` элемента коллекции,
а в качестве значения свойство `$valueName`.

``` php
$arr = [
    ['id' => '10', 'name' => 'First', ],
    ['id' => '20', 'name' => 'Second', ],
    ['id' => '30', 'name' => 'Third', ],
];
$collect = new Collection($arr);
$keyValueArray = $collect->forSelect('name')
//[
//    '10' => 'First',
//    '20' => 'Second',
//    '30' => 'Third',
//]

forSelectWithPrepend(string $valueName, string $keyName = 'id', array $prepend = ['' => 'Выбрать']): array, <sub>(*5)</sub>

Аналогично forSelect, только в начало массива добавляютсся данные из массива $prepend, <sub>(*6)</sub>

randomSafe (int $number = null): mixed, <sub>(*7)</sub>

Аналог стадандртного метода random, но в случае если размер коллекции меньше запрашиваемого числа элементов не выкидывается ошибка, а возвращается столько элементов сколько есть в коллекции, <sub>(*8)</sub>

php $collect = new Collection([1, 2, 3]); $randoms = $collect->randomSafe(10); echo sizeof($randoms); // 3, <sub>(*9)</sub>

Change log

Please see CHANGELOG for more information on what has changed recently., <sub>(*10)</sub>

Credits

• Denis Sandal
• All Contributors

License

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