mnapoli/blackbox

0.6.1 2015-01-10 01:47 UTC

This package is auto-updated.

Last update: 2024-10-19 21:24:41 UTC


README

BlackBox

BlackBox is a storage library that abstracts backends and data transformation behind simple interfaces.

Build Status Latest Version

Store data. "Where" and "how" can be decided later.

Experimental: this project is still at the state of experimentation. Use with caution.

Usage

The API is defined by interfaces and is extremely simple.

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.

Features

BlackBox can store data in:

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

Data can optionally be:

  • 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).

Backends

Backends are classes that implement Storage:

  • FileStorage
  • DirectoryStorage
  • DatabaseTable
  • ArrayStorage

You can read all about backends in the Backends documentation.

Transformers

Transformers transform data before storage and after retrieval:

  • JsonEncoder
  • YamlEncoder
  • ObjectArrayMapper
  • AesEncrypter

You can read all about transformers in the Transformers documentation.

// 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

License

BlackBox is released under the MIT license.