Micoli\Elql

A flat database manager. Each models are read/persisted in a (YAML|JSON) file.

That library is based upon symfony/serializer and symfony/expression-language components. So basically, every model that can be serialized/deserialized by those components wan be used.

When selecting, updating, deleting records, each constraints are expressed as an expression-language string. A record object is available in the constraint expression and represent the evaluated record.

Installation

This library is installable via Composer:

composer require micoli/elql

Requirements

This library requires PHP 8.0 or later.

Project status

While this library is still under development, it is still in early development status. It follows semver version tagging.

Quick start

Create an instance of Elql manager

Database are per directory. all models are persisted in a separate file.

$database = newElql(
newFilePersister(
'/var/lib/database',
newMetadataManager(),
YamlEncoder::FORMAT,
),
);

The persisted records are loaded in memory before each CRUD action if they were not already loaded.

Record in memory addition

Add some record of proper serializable model.

$database->add(
newBaz(1, 'a', 'a'),
newBaz(2, 'b', 'b'),
newBaz(3, 'c', 'c'),
newBaz(4, 'd', 'd'),
newFoo(1, 'aa', newDateTimeImmutable()),
);

Basic crud function are available

Select

$records = $database->find(Baz::class, 'record.id==3');

Update

An updater callback is used to help case/case model updates

$database->update(Baz::class, function (Baz$record) {
$record->firstName = $record->firstName . '-updated';
return$record;
}, 'record.id==3');

Delete

$database->delete(Baz::class, 'record.id in [1,4]');

Count

print$database->count(Baz::class, 'record.id in [1,4]');

You need to flush the in-memories tables to disk to persist them

$database->persister->flush();

/var/lib/database/Foo.yaml
/var/lib/database/Bar.yaml

Attributes

Table($name)

Instead of using the class-name as filename, you can specify a specific name using that attribute.

#[Table('b_a_z')]
class Baz
{
publicfunction__construct(
publicreadonlyint$id,
publicstring$firstName,
publicstring$lastName,
) {
}
}

N.B.:

if you don't want to use that attribute, you can specify some filenames in the MetadataManager constructor.

$database = newElql(
newFilePersister(
'/var/lib/database',
newMetadataManager([
Foo::class=>'foo_table'
]),
YamlEncoder::FORMAT,
),
);

In that was, when Foo records will be persisted, the filename will be foo_table.yaml.

Unique($expression, $indexName)

Before adding a record to a model table, the unique constraints are evaluated to guarantee uniqueness of records.

#[Unique('record.id')]
#[Unique('[record.firstName,record.lastName]', 'fullname')]
class Baz
{
publicfunction__construct(
publicreadonlyint$id,
publicstring$firstName,
publicstring$lastName,
) {
}
}

A Micoli\Elql\Exception\NonUniqueException are triggered in case of a constraint is not respected.