php man page for sqlite_factory

SQLITE_FACTORY(3)														 SQLITE_FACTORY(3)

sqlite_factory - Opens an SQLite database and returns an SQLiteDatabase object

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

DESCRIPTION
       sqlite_factory(3)  behaves  similarly  to sqlite_open(3) 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(3) reference page  for  further	usage  and
       caveats.

PARAMETERS
	      o $filename
		- The filename of the SQLite database.

	      o $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 0666 and this is the recommended value.

	      o $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.

RETURN VALUES
	Returns an SQLiteDatabase object on success, NULL on error.

EXAMPLES
       Example #1

	      sqlite_factory(3) example

	      <?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');

	      ?>

SEE ALSO
       sqlite_open(3), sqlite_popen(3).

PHP Documentation Group 													 SQLITE_FACTORY(3)