nicmart / arrayze
A callback-based decorator that gives array access to values.
Requires
- php: >=5.5
Requires (Dev)
- nicmart/benchmark: *
- satooshi/php-coveralls: dev-master
README
Give your values a lazy array interface!
What is Arrayze?
Arrayze gives you an adapter for ArrayAccess and Traversable php interfaces. The adapter is built from a collection of callbacks, that maps the original value to runtime-computed values.
This means that you can easily give your objects or values an array-like interface, specifying how to compute offsets through callbacks.
Example
Let's suppose you have a Person class:
class Person { private $firstName; private $lastName; private $birthYear; public function __construct($firstName, $surname, $birthYear) { ... } public function getFirstName() { return $this->firstName; } public function getLastName() { return $this->lastName; } public function getBirthYear() { return $this->birthYear; } }
You can then specify a collection of maps:
use NicMart\Arrayze\MapsCollection; $maps = (new MapsCollection)->registerMaps([ "first name" => function(Person $p) { return $p->getFirstName(); }, "last name" => function(Person $p) { return $p->getFirstName(); }, "full name" => function($_, $x) { return "{$x['first name']} {$x['last name']}"; }, "age" => function(Person $p) { return date("Y") - $p->getBirthYear(); }, "name and age" => function($_, $x) { return "{$x['full name']}, {$x['age']}" } ]);
With that collection in place, you can now adapt Person instances to the new lazy array interface:
use NicMart\Arrayze\ArrayAdapter; $nic = new Person("Nicolò", "Martini", 1983); $arrayzedNic = new ArrayAdapter($nic, $maps); echo $arrayzedNic["full name"]; // Prints "Nicolò Martini" echo $arrayzedNic["age"]; // Prints 31 echo $arrayzedNic["name and age"]; // Prints "Nicolò Martini, 31"
ArrayAdapter
implements also the Iterator
interface, so you can iterate (lazily)
through your arrayzed objects:
foreach ($arrayzedNic as $key => $value) echo "$key: $value\n"; // Prints // first name: Nicolò // last name: Martini // full name: Nicolò Martini // age: 31 // name and age: Nicolò Martini, 31
Convert to array
You can easily convert your adapted object to a native array with the ArrayAdapter::toArray()
method.
Install
The best way to install Arrayze is through composer.
Just create a composer.json file for your project:
{ "require": { "nicmart/arrayze": "~0.1" } }
Then you can run these two commands to install it:
$ curl -s http://getcomposer.org/installer | php
$ php composer.phar install
or simply run composer install
if you have have already installed the composer globally.
Then you can include the autoloader, and you will have access to the library classes:
<?php require 'vendor/autoload.php';