Home > PHP > Function > SQLite > sqlite_factory()

sqlite_factory()

sqlite_factory - Opens a SQLite database and returns a SQLiteDatabase object

Syntax

sqlite_factory (string $filename, int $mode, string &$error_message)

Arguments

  • filename - The filename of the SQLite database.
  • mode - The mode of the file. Intended to be used to open the database in read-only mode. Presently, this parameter is ignored by the sqlite library. The default value for mode is the octal value 0666and this is the recommended value.
  • error_message - Passed by reference and is set to hold a descriptive error message explaining why the database could not be opened if there was an error.

Description

sqlite_factory() behaves similarly to sqlite_open() in that it opens an SQLite database or attempts to create it if it does not exist. However, a SQLiteDatabaseobject is returned rather than a resource. Please see the sqlite_open() reference page for further usage and caveats.

Version

PHP 5

Return value

Returns a SQLiteDatabase object on success, NULL on error.