sqlite_factory

(PHP 5 < 5.4.0)

sqlite_factory — Ö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() - Öffnet eine SQLite-Datenbank und erzeugt die Datenbank, wenn diese nicht existiert.
  • sqlite_popen() - Öffnet eine persistente Verbindung zu einer SQLite-Datenbank und erzeugt diese im Bedarfsfall