70 lines
1.8 KiB
Markdown
70 lines
1.8 KiB
Markdown
Ary
|
|
===
|
|
|
|
Ary provides unified interface for ary/object. Really handy to store:
|
|
|
|
- arrays/objects those their items/properties varies conditionally.
|
|
- storing registry, system configuration, env variables, etc.
|
|
- when you perform a chain of action on an array/object
|
|
|
|
It's super cool and after a while you can not code in php without it.
|
|
|
|
Features
|
|
---------
|
|
1. You can access array items using `->` or `['']` syntax.
|
|
2. You will get `null` if an index does not exists (instead of a nasty notification!)
|
|
3. You can specify a default value for missing indexes.
|
|
4. You can set/get a value within a deeply nested array using "dot" notation.
|
|
5. A bunch of really handy methods: `merge`, `only`, `search`, `toObject`, ...
|
|
6. Now, `Ary` extends `Illuminate\Support\Collection` class so all of its methods are available (https://laravel.com/docs/master/eloquent-collections)
|
|
|
|
Examples
|
|
--------
|
|
~~~~~
|
|
// Instantiation
|
|
$ary = new Ary();
|
|
// or simply
|
|
$ary = ary();
|
|
|
|
//Initialization
|
|
$ary = ary(2, 4, 6, 8); // or
|
|
$ary = ary([2, 4, 6, 8]);
|
|
$ary = ary(['x' => 'foo', 'y' => 'bar']);
|
|
|
|
//Assignment
|
|
$ary->newItem=20; //or
|
|
$ary['newItem']=20;
|
|
|
|
//Retrieval
|
|
$foo = $ary->x; //or
|
|
$foo = $ary['x'];
|
|
$missed = $ary->get('missed', 'Default value');
|
|
$ary->all(); // returns the simple php array;
|
|
|
|
// works as regular arrays
|
|
count($ary); //returns 3
|
|
unset($ary[0]);
|
|
json_encode($ary);
|
|
|
|
// deep assignment/retrieval
|
|
$ary = ary(['products' => ['desk' => ['price' => 100]]]);
|
|
$value = $ary['products.desk.price']; //100
|
|
$ary['production.table.weight']=200;
|
|
|
|
~~~~~~
|
|
|
|
Installation
|
|
============
|
|
Simply `include '__DIR__.'/src/helper.php';`
|
|
|
|
or use Composer:
|
|
|
|
composer require salarmehr/ary
|
|
|
|
* The class (`Ary()`) requires PHP 5.4 or above.
|
|
* The helper function (`ary()`) requires PHP 5.6 or above.
|
|
|
|
Licence
|
|
=======
|
|
MIT
|