dba_open

(PHP 4, PHP 5, PHP 7, PHP 8)

dba_open — Öffnet eine Datenbank

Beschreibung

dba_open(
    string $path,
    string $mode,
    string $handler = ?,
    string ...$args
): resource|false

dba_open() stellt eine Datenbankinstanz für path mit mode her und verwendet dabei handler.

Parameter-Liste

path

Ein gültiger Pfad in Ihrem Dateisystem.

mode

Das ist r für lesenden Zugriff, w für lesenden und schreibenden Zugriff auf eine existierende Datenbank, c für lesenden und schreibenden Zugriff und Erstellen der Datenbank, falls sie noch nicht existiert, und n für das Erstellen einer Datenbank, bzw. deren Zurücksetzen auf die Größe 0, falls sie schon existiert, und lesenden und schreibenden Zugriff. Die Datenbank wird im BTree-Modus erzeugt. Andere Modi, wie Hash oder Queue, werden nicht unterstützt.

Zusätzlich können Sie mit dem nächsten Buchstaben die Datenbank-Sperrmethode festlegen. Verwenden Sie l, um die Datenbank mit einer .lck-Datei zu sperren, oder d, um die Datenbank-Datei selbst zu sperren. Es ist wichtig, dass alle Ihre Anwendungen das einheitlich machen.

Falls Sie den Zugriff testen wollen, ohne auf die Sperrung zu warten, können Sie t als dritten Buchstaben anfügen. Wenn Sie sich absolut sicher sind, dass Sie keine Datenbanksperre benötigen, können Sie statt l oder d - verwenden. Wenn weder d oder l noch - verwendet werden, sperrt dba die Datenbank-Datei wie bei Verwendung von d.

Hinweis:
Es kann jeweils nur einen Schreibzugriff auf eine Datenbank-Datei geben. Wenn dba auf einen Webserver verwendet wird und mehr als eine Anfrage Schreibzugriff benötigt, kann nur einer nach dem anderen erledigt werden. Auch das Lesen ist während des Schreibens nicht erlaubt. Die DBA-Erweiterung verwendet Sperren, um dies zu verhindern. Siehe folgende Tabelle:
DBA-Sperrung

schon geöffnet Modus = "rl" Modus = "rlt" Modus = "wl" Modus = "wlt" Modus = "rd" Modus = "rdt" Modus = "wd" Modus = "wdt"

nicht geöffnet OK OK OK OK OK OK OK OK

Modus = "rl" OK OK warten false unzulässig unzulässig unzulässig unzulässig

Modus = "wl" warten false warten false unzulässig unzulässig unzulässig unzulässig

Modus = "rd" unzulässig unzulässig unzulässig unzulässig OK OK warten false

Modus = "wd" unzulässig unzulässig unzulässig unzulässig warten false warten false

OK: der zweite Aufruf ist erfolgreich.

warten: der zweite Aufruf wartet bis für den ersten dba_close() aufgerufen wird.

false: der zweite Aufruf gibt false zurück.

unzulässig: Sie dürfen beim Parameter Modus die Modifikatoren "l" und "d" nicht zusammen verwenden.

Handler

**DBA-Sperrung**
schon geöffnet	`Modus` = "rl"	`Modus` = "rlt"	`Modus` = "wl"	`Modus` = "wlt"	`Modus` = "rd"	`Modus` = "rdt"	`Modus` = "wd"	`Modus` = "wdt"
nicht geöffnet	OK	OK	OK	OK	OK	OK	OK	OK
`Modus` = "rl"	OK	OK	warten	`false`	unzulässig	unzulässig	unzulässig	unzulässig
`Modus` = "wl"	warten	`false`	warten	`false`	unzulässig	unzulässig	unzulässig	unzulässig
`Modus` = "rd"	unzulässig	unzulässig	unzulässig	unzulässig	OK	OK	warten	`false`
`Modus` = "wd"	unzulässig	unzulässig	unzulässig	unzulässig	warten	`false`	warten	`false`

Der Name des handlers, der für den Zugriff auf path benutzt werden soll. Er bekommt alle optionalen Argumente, die der Funktion dba_open() mitgegeben wurden, übergeben und kann damit in deren Name verfahren.

args

Optionale String-Parameter, die an den Treiber übergeben werden.

Die cdb-, cdb_make-, flatfile-, inifile-, qdbm- und tcadb-Treiber unterstützen keine zusätzlichen Parameter.

Die db1-, db2-, db3-, db4-, dbm-, gdbm- und ndbm-Treiber unterstützen einen einzigen zusätzlichen Parameter $filemode, der dieselbe Bedeutung wie der $mode-Parameter von chmod() hat, und dessen Standardwert 0644 ist.

Der lmdb-Treiber akzeptiert zwei zusätzliche Parameter. Der erste erlaubt es den $filemode anzugeben (siehe Beschreibung weiter oben), und der zweite die $mapsize, wobei der Wert ein Vielfaches der Pagesize des Betriebssystems sein sollte, oder Null, um die voreingestellte Mapsize zu verwenden. Der $mapsize-Parameter wird von PHP 7.3.14 bzw. 7.4.2 an unterstützt.