wikimedia/cdb

Constant Database (CDB) wrapper library for PHP. Provides pure-PHP fallback when dba_* functions are absent.

Maintainers

Details

github.com/wikimedia/cdb

Homepage

Source

Installs: 855 098

Dependents: 4

Suggesters: 0

Security: 0

Stars: 13

Watchers: 15

Forks: 9

3.0.0 2023-07-24 18:27 UTC

Requires

  • php: >=7.4.0

Requires (Dev)

Suggests

  • ext-dba: PHP extension for DBA access. Would be quicker than the PHP based fallback

GPL-2.0-or-later 3d7622f39319ea2149cac92415222d1fb39c46d0

  • Tim Starling <tstarling.woop@wikimedia.org>
  • Chad Horohoe <chad.woop@wikimedia.org>
  • Ori Livneh <ori.woop@wikimedia.org>
  • Daniel Kinzler

This package is auto-updated.

Last update: 2024-12-12 05:50:24 UTC

README

Latest Stable Version License

CDB functions for PHP

CDB, short for "constant database", refers to a very fast and highly reliable database system which uses a simple file with key value pairs. This library wraps the CDB functionality exposed in PHP via the dba_* functions. In cases where dba_* functions are not present or are not compiled with CDB support, a pure-PHP implementation is provided for falling back.

Additional documentation about the library can be found on mediawiki.org.

Usage

// Reading a CDB file
$cdb = Cdb\Reader::open( 'db.cdb' );
$foo = $cdb->get( 'somekey' );

// Writing to a CDB file
$cdb = Cdb\Writer::open( 'anotherdb.cdb' );
$cdb->set( 'somekey', $foo );
// Using the CLI
$ cdb ./myfile.cdb [get|list|match] <parameter>

Running tests

composer install --prefer-dist
composer test

History

This library was first introduced in MediaWiki 1.16 (r52203). It was split out of the MediaWiki codebase and published as an independent library during the MediaWiki 1.25 development cycle.