asgard/data

Data

, _(*1)

Data is package for key-value database storage., _(*2)

• Installation
• Usage in the Asgard Framework
• Usage outside the Asgard Framework
• Fetch a value
• Store a value
• Delete a key
• Check for a key existence
• Working with different data types

, _(*3)

Installation

If you are working on an Asgard project you don't need to install this library as it is already part of the standard libraries., _(*4)

composer require asgard/data 0.*

, _(*5)

Usage in the Asgard Framework

$data = $container['data'];

The container is often accessible as a method parameter or through a ContainerAware object. You can also use the singleton but it is not recommended., _(*6)

, _(*7)

Usage outside the Asgard Framework

$config = [
    'host' => 'localhost',
    'user' => 'root',
    'password' => '',
    'database' => 'asgard',
    'prefix' => '',
    'driver' => 'mysql'
];
$db = new \Asgard\Db\DB($config);
$data = new \Asgard\Data\Data($db);

, _(*8)

Fetch a value

$data->get('key', 'default'); #'default' if returned in the value could not fetched
#or
$data['key'];

, _(*9)

Store a value

$data->set('key', 'value');
#or
$data['key'] = 'value';

, _(*10)

Delete a key

$data->delete('key');
#or
unset($data['key']);

, _(*11)

Check for a key existence

$data->has('key');
#or
isset($data['key']);

, _(*12)

Working with different data types

Register a type, _(*13)

$data->register('obj',
    function($obj) {
        return serialize($obj);
    },
    function($str) {
        return unserialize($str);
    }
);

Store a value with a specific type, _(*14)

$obj = new StdClass;
$obj->name = 'bob';
$data->set('key', $obj, 'obj');

Contributing

Please submit all issues and pull requests to the asgardphp/asgard repository., _(*15)

License

The Asgard framework is open-sourced software licensed under the MIT license, _(*16)