jzaleski/php-open_struct

A very flexible data-structure (inspired by Ruby's `ostruct` library)

Open_Struct (PHP)

, _(*1)

A very flexible data-structure (inspired by Ruby's ostruct library), _(*2)

Requirements

This library requires PHP 5.4+, _(*3)

Installation

You can easily install Open_Struct with the following command:, _(*4)

composer [global] require 'jzaleski/php-open_struct=*'

Usage

Creating a new [empty] instance:, _(*5)

$struct = new Open_Struct;

Creating a new instance from an array of attributes:, _(*6)

$struct = new Open_Struct(['foo' => 1, 'bar' => ['biz' => 2]]);

Dereferencing a top-level value:, _(*7)

$value = $struct->foo;

Getting a top-level value by index/key:, _(*8)

$value = $struct['foo'];

Dereferencing a nested value:, _(*9)

$nested_value = $struct->bar->biz;

Getting a nested value by index/key:, _(*10)

$nested_value = $struct['bar']['biz'];

Setting a top-level value:, _(*11)

$struct->foo = 2;

Setting a top-level value by index/key:, _(*12)

$struct['foo'] = 2;

Setting a nested value:, _(*13)

$struct->bar->biz = 3;

Setting a nested value by index/key:, _(*14)

$struct['bar']['biz'] = 3;

Unsetting a top-level value:, _(*15)

unset($struct->foo);

Unsetting a top-level value by index/key:, _(*16)

unset($struct['foo']);

Checking for the existence of a key:, _(*17)

isset($struct->foo);

Checking for the existence of a key by index/key:, _(*18)

isset($struct['foo']);

Setting a callback value (this is useful for scenarios where you want to derive or lazy-load a property):, _(*19)

$dao = new Data_Access_Object;

$struct = new Open_Struct(['something' => function() use ($dao) { return $dao->get_something(); }]);

$struct->something;

The dirty method will return false until initialization (the constructor) is complete:, _(*20)

$struct = new Open_Struct(['foo' => 1]);

$struct->dirty(); // returns: `false`

The dirty method will return true, after initialization (the constructor), when a value is set:, _(*21)

$struct = new Open_Struct;

$struct->foo = 1;

$struct->dirty(); // returns: `true`

The dirty method will return false, after initialization (the constructor), when a value is set back to its original state:, _(*22)

$struct = new Open_Struct(['foo' => 1]);

$struct->foo = 2;

$struct->dirty(); // returns: `true`

$struct->foo = 1;

$struct->dirty(); // returns: `false`

Getting the array of attributes:, _(*23)

$struct = new Open_Struct(['foo' => 1]);

$struct->foo = 2;

$struct->bar = 3;

$struct->attributes(); // returns: `['foo' => 2, 'bar' => 3]`

Getting the array of changed attributes:, _(*24)

$struct = new Open_Struct(['foo' => 1]);

$struct->bar = 2;

$struct->changed_attributes(); // returns: `['bar' => 2]`

The changed_attributes method will return an empty array. after initializaiton (the constructor), when a value is set back to its original state:, _(*25)

$struct = new Open_Struct(['foo' => 1]);

$struct->foo = 2;

$struct->changed_attributes(); // returns: `['foo' => 2]`

$struct->foo = 1;

$struct->changed_attributes(); // returns: `[]`

Contributing

1. Fork it ( http://github.com/jzaleski/php-open_struct/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request