PopisSQLiteDatabase sqlite_factory ( string filename [, int mode [, string &error_message]] )
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 SQLiteDatabase object is returned rather than a resource. Please see the sqlite_open() reference page for further usage and caveats.
The filename of the SQLite database.
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 0666 and this is the recommended value.
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.