Collection pattern implementation with map, flatMap, reduce, sort, unique etc. methods. Serializable to JSON.
PHP >= 7.1
This package is available on composer via packagist.
composer require jarjak/collection
useJarJak\Collection\Collection;
$dateArray = [
newDateTime(),
newDateTimeImmutable(),
];
$dateCollection = newCollection(...$dateArray);
# or$dateCollection = Collection::from($dateArray);
# then do what you know from other collection implementations$plusYears = $dateCollection
->map(fn($date) => $date->modify('+1 year'))
->toArray();One of the coolest features of this implementation is that you can set up your own specific, type-aware collections (think about them like aggregates / repositories). Then you can encapsulate any custom operations that you need to perform on a group of same-type objects (instead for doing it in foreach loop somewhere in your controller / service).
useJarJak\Collection\Collection;
class DateCollection extends Collection
{
// accept only date objectspublicfunction__construct(DateTimeInterface ...$items)
{
parent::__construct(...$items);
}
// you can personalize it by adding custom methods too!publicfunctiongetMaxYear(): int
{
return$this->reduce(
0, function (int$current, DateTimeInterface$date): int {
$year = (int) $date->format('Y');
return$current > $year ? $current : $year; }
);
}
}
# this is acceptable$dateCollection = newDateCollection(
newDateTime(),
newDateTimeImmutable()
);
# this will result in an error$dateCollection = newDateCollection(
newDateTime(),
newDateTimeImmutable(),
date('now')
);
# then this will work$plusYears = $dateCollection->map(fn($date) => $date->modify('+1 year'));
# but this won't$dateStrings = $dateCollection->map(fn($date) => $date->format('Y-m-d'));
# unless you explicitly disable type check (which effectively sends you back to the base Collection class)$dateStrings = $dateCollection
->disableTypeCheck()
->map(fn($date) => $date->format('Y-m-d'));