PHP-Handbuch: Öffnet eine SQLite-Datenbank und gibt ein SQLiteDatabase-Objekt zurück

Beschreibung

SQLiteDatabase sqlite_factory ( string $filename [, int $mode = 0666 [, string &$error_message ]] )

sqlite_factory verhält sich ähnlich zu sqlite_open, indem es eine SQLite-Datenbank öffnet oder diese erzeugt, sollte sie nicht vorhanden sein. Allerdings wird ein SQLiteDatabase-Objekt anstelle einer Resource zurückgegeben. Für weitere Details und Einschränkungen bitte auf der Referenzseite von sqlite_open nachsehen.

Parameter-Liste

filename: Der Dateiname der SQLite-Datenbank.
mode: Der Parameter mode spezifiziert den Modus der Datei und sollte genutzt werden, wenn die Datenbank nur Lesezugriff erlauben soll. Zur Zeit wird dieser Parameter von der SQLite-Bibliothek ignoriert. Der Standardwert für Modus ist der oktale Wert 0666. Es handelt sich dabei um den empfohlenen Wert, wenn der Parameter error_message genutzt werden soll.
error_message: Wird als Referenz übergeben und gesetzt, um bei einem Fehler eine ausführliche Fehlermeldung zu erhalten, die erklärt, warum sich die Datenbank nicht öffnen lässt.

Rückgabewerte

Liefert ein SQLiteDatabase-Objekt bei einer erfolgreichen Verbindung, sonst NULL.

Beispiele

Beispiel #1 sqlite_factory Beispiel


<?php
$dbhandle = sqlite_factory('sqlitedb');
$dbhandle->query('SELECT user_id, username FROM users');

/* functionally equivalent to: */

$dbhandle = new SQLiteDatabase('sqlitedb');
$dbhandle->query('SELECT user_id, username FROM users');

?>

Siehe auch

sqlite_open
sqlite_popen