High-performance, low-memory-footprint, single-file embedded database for key/value storage
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
LICENSE.md
README.md
composer.json
ldba.php

README.md

LDBA - a fast, pure PHP, key-value database.

Information

LDBA is a high-performance, low-memory-footprint, single-file embedded database for key/value storage and retrieval written in pure PHP.

It is inspired by Erlang's Dets and Berkeley DB sofware and includes implementation of extended linear hashing for fast key/value access and implementation of a fast buddy storage allocator for file space management.

LDBA supports insertion and deletion of records and lookup by exact key match only. Applications may iterate over all records stored in a database, but the order in which they are returned is undefined. Fault tolerance is achieved by automatic crash recovery thanks to transactional style writes. The size of LDBA files cannot exceed 2GB.

LDBA provides functions compatible with php_dba (Database Abstraction Layer) for easy adoption in existing software.

Requirements: PHP 5.4+

The library is being used, for example, as base storage interface in the PrivMX WebMail software.

Instalation

Run the following command to install the lib via composer:

composer require simplito/ldba-php

An example

$dbh = ldba_open("test.ldb", "c");
if (ldba_exists("counter", $dbh)) {
    $counter = intval(ldba_fetch("counter", $dbh));
} else {
    $counter = 0;
}
ldba_replace("counter", $counter + 1);
ldba_close($dbh);