sqlite_factory
(PHP 5)
sqlite_factory — Öffnet eine SQLite-Datenbank und gibt ein SQLiteDatabase-Objekt zurück.
Beschreibung
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 06666. 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
Example#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');
?>