README

Provides an object to store and access data arrays with dot notation support.

Usage

A new data container instance can be created empty or from data provided as array, object or another Devly\Repository instance.

$repository = new \Devly\Repository();

// Or create with initial data
$repository = new \Devly\Repository(['user' => [...]]);

Can also be created using the static method Devly\Repository::new()

set()

$repository->set('user.name', 'johndoe');

// Or as array
$repository['user.name'] = 'johndoe';

// Equivalent vanilla PHP
$array['user']['name'] = 'johndoe';

get()

Retrieves data by key name

$username = $repository->get('user.name');

// Or as array
$username = $repository['user.name'];

// Equivalent vanilla PHP
$username = $array['user']['name'];

has()

Check whether a key name exists

$repository->has('user.name');

// Or as array
isset($repository['user.name']);

// Equivalent vanilla PHP
isset($array['user']['name']);

all()

Returns all the data as array

$array = $repository->all();

remove()

Removes given key

$repository->remove('user.name');

// Or as array
unset($repository['user.name']);

clear()

Removes all the data

$repository->clear();

count()

Counts the number of items in the data container

$repository->count();

// Or using the count function
count($repository);

isEmpty()

Checks whether the container contains data

$repository->isEmpty();

toJson()

Returns a JSON representation of the data

Returns the value of a given key as JSON:

$repository->toJson('user');

Returns all the stored items as JSON:

$repository->toJson();

// Same as:
json_encode($repository);

createFrom()

Create a new Repository instance from an existing item

$repository  = new Repository(['name' => ['first' => 'John', 'last' => 'Doe']]);
$repository2 = $repository->createFrom('name');

$repository2->all(); // ['first' => 'John', 'last' => 'Doe']

merge()

Merge array, object or an instance of IRepository into the current Repository

$repository = new Repository(['first' => 'John', 'last' => 'Doe']);

$repository->merge(new Repository(['first' => 'Johnny']));

// Can also be merged with an object
$repository->merge((object) ['first' => 'Johnny']);

// Can also be merged with an object
$repository->merge(['first' => 'Johnny']);

$repository->all(); // ['first' => 'Johnny', 'last' => 'Doe']

mergeRecursive()

Merge array, object or an instance of IRepository into the current Repository recursively

$repository = new Repository(['name' => ['first' => 'John', 'last' => 'Doe']]);

$repository->mergeRecursive(['name' => ['first' => 'Johnny']]);

$repository->all(); // ['name' => ['first' => 'Johnny', 'last' => 'Doe']