currentMenu: home

BlackBox

BlackBox is a storage library that abstracts backends and data transformation behind simple interfaces., _(*1)

, _(*2)

Store data. "Where" and "how" can be decided later., _(*3)

Experimental: this project is still at the state of experimentation. Use with caution., _(*4)

Usage

The API is defined by interfaces and is extremely simple., _(*5)

namespace BlackBox;

interface Storage extends Traversable
{
    public function get(string $id);
    public function set(string $id, $data) : void;
    public function remove(string $id) : void;
}

$storage->set('foo', 'Hello World!');

echo $storage->get('foo'); // Hello World!

foreach ($storage as $key => $item) {
    echo $key; // foo
    echo $item; // Hello World!
}

You can read all about those interfaces in the Interfaces documentation., _(*6)

Features

BlackBox can store data in:, _(*7)

files
database (MySQL, PostgreSQL, SQLite, Oracle, …) using Doctrine DBAL
PHP arrays (i.e. in memory)

Data can optionally be:, _(*8)

stored in JSON
stored in YAML
encrypted with AES

Additionally a storage can be cached with another (e.g. cache a DB storage with a Redis or array storage)., _(*9)

Backends

Backends are classes that implement Storage:, _(*10)

FileStorage
DirectoryStorage
DatabaseTable
ArrayStorage

You can read all about backends in the Backends documentation., _(*11)

Transformers

Transformers transform data before storage and after retrieval:, _(*12)

JsonEncoder
YamlEncoder
ObjectArrayMapper
AesEncrypter

You can read all about transformers in the Transformers documentation., _(*13)

// Encode the data in JSON
$storage = new JsonEncoder(
    // Store data in files
    new DirectoryStorage('some/directory')
);

$storage->set('foo', [
    'name' => 'Lebowski',
]);
// will encode it in JSON
// then will store it into a file

$data = $storage->get('foo');
// will read from the file
// then will decode the JSON

echo $data['name']; // Lebowski