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)
