Eine objektoriertierte Schnittstelle für die DBA-Funktionen von PHP.

Der Apache-Webserver kann die Benutzerinformationen für die Authentifizierung aus einer DBM-Datei laden.

Auf viele Methoden kann auch über die Array-Syntax zugegriffen werden.

Die verfügbaren Treiber (die im Parameter driverName angegeben werden) können über die statische Methode Dba::getDrivers() abgefragt werden. Eine typische Ausgabe kann wie folgt aussehen:

array(5) {
   [0]=>
   string(3) "cdb"
   [1]=>
   string(8) "cdb_make"
   [2]=>
   string(7) "inifile"
   [3]=>
   string(8) "flatfile"
   [4]=>
   string(4) "qdbm"
}

Welche Datenbanktreiber unterstützt werden, hängt vom jeweiligen System und den Einstellungen ab mit denen PHP kompiliert wurde. Falls eine neue Datenbankdatei angelegt werden soll, kann für die Entscheidung welcher Treiber verwendet werden soll, der Benchmarkvergleich von Tokyo Tyrant hilfreich sein.

$dba = new Dba('test.ini', Dba::MODE_READ | Dba::MODE_WRITE | Dba::MODE_CREATE, [
    'driverName' => 'inifile'
]);

$dba = new Dba('test.gdbm', Dba::MODE_READ | Dba::MODE_WRITE | Dba::MODE_CREATE, [
    'driverName' => 'gdbm'
]);

CDB kann entweder mit der Option driverName cdb_make erstellt oder mit der Option driverName cdb gelesen werden. Das Aktualisieren oder Löschen von Einträgen ist nicht möglich.

$dba = new Dba('test.cdb', Dba::MODE_WRITE | Dba::MODE_CREATE, [
    'driverName' => 'cdb_make'
]);

$dba = new Dba('test.cdb', Dba::MODE_READ, [
    'driverName' => 'cdb'
]);

$dba->setValue('foo', 23);
$dba->setValue('bar', 42);

$dba['foo'] = 23;
$dba['bar'] = 42;

$dba->exists('foo');

isset($dba['foo']);

$dba->addValue('foo', 23);
$dba->addValue('foo', 42);

$dba->removeValues('bar');

unset($dba['bar']);

foreach($dba as $key => $value) {
    var_dump($value);
}

Da diese Klasse ein Wrapper für die DBA-Funktionen von PHP sind müssen diese verfügbar sein, um diese Klasse verwenden zu können. Diese Funktionen können je nach Betriebsystem als eigenes Paket verfügbar sein oder sind bereits mit PHP einkompiliert.

Abhängigkeiten von blar/dba auf gemnasium anzeigen

$ composer require blar/dba

$ git clone https://github.com/blar/dba.git