Latest Stable Version Latest Unstable Version License Maintainability Test Coverage SensioLabsInsight

Utilities

some utilities for php, nothing special, nothing new, just to my taste

Installation

installation is simply done via composer composer require chris-kruining/utilities

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

for example

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

would yield

'these are some test values'

which is the same as

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

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

would yield

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

which is the same as

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

join('|', array_map(function($k, $v){ return $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

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

Made by Jason, Chris and Shawn

© 2020 Builtneat, Inc. All rights reserved.