AEngine Memory

Work with Key-Value storage by user-friendly interface.

Requirements

• PHP >= 7.0

Supporting

• Memcache
• Redis

Installation

Run the following command in the root directory of your web project:

composer require aengine/memory

Usage

Connect to the server

AEngine\Memory\Mem::initialize([
    [
        'host'    => 'localhost',
        'port'    => '11211',
        'timeout' => 10,
        // additional can be passed options, server-role and pool name:
        // 'driver' => 'memcache', // or redis
    ]
]);

Write data to storage

AEngine\Memory\Mem::set('foo', 'bar');

Read data form storage

AEngine\Memory\Mem::get('foo', /* 'default value' */);

// -- or --

AEngine\Memory\Mem::get('foo', function () {
    // some action, e.g. just return string
    return 'baz';
});

Get or Set Multiple (like a PSR-16)

// set rows
AEngine\Memory\Mem::setMultiple([
    'cat:0' => 'Kiki',
    'cat:1' => 'Lucky',
    'dog:0' => 'Bucks',
    'cat:2' => 'Simon',
    'dog:1' => 'Eugene',
    'cat:3' => 'Rocky',
], 3600, 'animal');

// get data
$animals = AEngine\Memory\Mem::getMultiple(['cat:0', 'cat:1', 'dog:0', 'cat:2', 'dog:1', 'cat:3']);

// remove data
AEngine\Memory\Mem::deleteMultiple(['cat:0', 'cat:1', 'dog:0', 'cat:2', 'dog:1', 'cat:3']);

Tags

// set few rows
AEngine\Memory\Mem::set('cat:0', 'Kiki', 3600, 'animal');
AEngine\Memory\Mem::set('cat:1', 'Lucky', 3600, 'animal');
AEngine\Memory\Mem::set('dog:0', 'Bucks', 3600, 'animal');
AEngine\Memory\Mem::set('cat:2', 'Simon', 3600, 'animal');
AEngine\Memory\Mem::set('dog:1', 'Eugene', 3600, 'animal');
AEngine\Memory\Mem::set('cat:3', 'Rocky', 3600, 'animal');

// get data as array
$animal = AEngine\Memory\Mem::getByTag('animal');

// remove data
AEngine\Memory\Mem::deleteByTag('animal');

Contributing

Please see CONTRIBUTING for details.

License

The AEngine Memory is licensed under the MIT license. See License File for more information.