chris-kruining/utilities

Utilities for PHP 7.1^

, _(*1)

Utilities

some utilities for php, nothing special, nothing new, just to my taste, _(*2)

Installation

installation is simply done via composer composer require chris-kruining/utilities, _(*3)

Usage

The main component of the library is the Collection at the moment. The goal of the Collection is to provide a object oriented interface for array functions. It also has a couple of extra's like method chaining and linq-esc implementation(NOT DONE YET) so that you may interact with the Collection as if it was a database table, _(*4)

for example, _(*5)

CPB\Utilities\Collections\Collection::from([ 'these', 'are', null, null, 'some', null, 'test', 'values', null ])
  ->filter()
  ->toString(' ');

would yield, _(*6)

'these are some test values'

which is the same as, _(*7)

join(' ', array_filter([ 'these', 'are', null, null, 'some', null, 'test', 'values', null ]));

I agree, the vannilla way is shorter now but the strength really comes into play when we start adding callbacks and increase the chain length, _(*8)

CPB\Utilities\Collections\Collection::from([ 'these', '', '', 'are', null, 'some', null, 'test', '', 'values', '' ])
  ->filter(fn($v) => $v !== null && strlen($v) > 0)
  ->map(fn($k, $v) => $k . '::' . $v)
  ->toString('|');

would yield, _(*9)

'0::these|1::are|2::some|3::test|4::values'

which is the same as, _(*10)

$filtered = array_filter(
  [ 'these', '', '', 'are', null, 'some', null, 'test', '', 'values', '' ], 
  fn($v) => $v !== null && strlen($v) > 0
);

join('|', array_map(fn($k, $v) => $k . '::' . $v, array_keys($filtered), $filtered));

As you can see the collection version maintains readability whereas the vannilla version loses in my opinion it's charm because to achieve a single goal you need to spread it out over multiple variables, _(*11)

Roadmap

• [X] Implement basic features to Collection
• [X] Bloat Collection with features :P
• [X] Split of features into an inheritance tree
• [X] Split lazy mode from Collection into LazyCollection and implement PHP's array functions as generators
• [ ] Finish inheritance structure
• [ ] Implement LazyCollection
• [X] (Better) implement the Queryable interface in a new class so the Collection doesn't become bloated