blar / dba

DBA für PHP

DBA

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

Verwendung

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

Beispiele

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

Verfügbare Treiber

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.

Datenbank erstellen

INI-Datei

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

GNU Database Manager (GDBM)

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

Tiny Constant Database (CDB)

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'
]);

Einträge setzen

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

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

Einträge prüfen

$dba->exists('foo');

isset($dba['foo']);

Einträge hinzufügen

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

Einträge löschen

$dba->removeValues('bar');

unset($dba['bar']);

Alle Einträge in einer Datenbank auslesen

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

Installation

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

Abhängigkeiten von blar/dba auf gemnasium anzeigen

Installation per Composer

$ composer require blar/dba

Installation per Git

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