tebru / multi-array
Provides a data structure to ease access to multidimensional arrays in PHP
Installs: 3 096
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 3
Forks: 1
Open Issues: 3
Requires
- php: >=5.4
Requires (Dev)
- php: >=5.5
- mockery/mockery: dev-master
- phpunit/phpunit: 4.3.*
This package is auto-updated.
Last update: 2024-10-24 10:58:23 UTC
README
MultiArray
This project aims to provide easier access to multidimensional arrays. Json responses were in mind during the creation. The goal is to make it easier to check if keys are set multiple levels deep, and retrieve the value.
Installation
composer require tebru/multi-array:~0.1
Usage
Create the object by either instantiating it or using the factory. i Pass in a json object or array. An InvalidArgumentException will be thrown if it can't decode the json, or the variable isn't an array.
$array = [
'key' => 'value',
'key2' => ['nested-key' => 'value2'],
];
$multiArray = new MultiArray($array);
$multiArray = $multiArrayFactory->make($array);
$json = json_encode($array);
$multiArray = new MultiArray($json);
$multiArray = $multiArrayFactory->make($json);
From here you can check if a key exists
$multiArray->exists('key2.nested-key'); // returns true
$multiArray->exists('key3'); // returns false
Get the value of a key
$multiArray->get('key2'); // returns ['nested-key' => 'value2']
$multiArray->get('key2.nested-key'); // returns 'value2'
$multiArray->get('key3'); // throws OutOfBoundsException
Set the value of a key
$multiArray->set('key1', 'value');
$multiArray->set('key2.nested-key', 'value');
$multiArray->set('key2.newKey', 'value');
$multiArray->set('key1.newKey', 'value'); // throws InvalidArgumentException
Remove the value of a key
$multiArray->remove('key1');
$multiArray->remove('key2.unknown'); // throws OutOfBoundsException
We default to delimiting keys by a period .
, but that can be changed during instantiation
$multiArray = new MultiArray($array, ':');
$multiArray = $multiArrayFactory->make($array, '--');
You can also access the object like a normal array
isset($multiArray['key2.nested-key']);
$multiArray['key2.nested-key'];
$multiArray['key2.nested-key'] = 'value';
unset($multiArray['key2.nested-key']);