dbx_connect() returns an object on success,
error. If a connection has been made but the database could not be
selected, the connection is closed and
FALSE is returned.
The persistent parameter can be set to
DBX_PERSISTENT, if so, a persistent connection will be
The module parameter can be either a string or a constant, though the latter form is preferred. The possible values are given below, but keep in mind that they only work if the module is actually loaded.
DBX_FBSQLor "fbsql" (available from PHP 4.1.0)
DBX_SYBASECTor "sybase_ct" (available from PHP 4.2.0)
DBX_OCI8or "oci8" (available from PHP 4.3.0)
DBX_SQLITEor "sqlite" (PHP 5)
The host, database, username and password parameters are expected, but not always used depending on the connect functions for the abstracted module.
object has three properties:
It is a valid handle for the connected database, and as such it can be used in module-specific functions (if required).
$link = dbx_connect(DBX_MYSQL, "localhost", "db", "username", "password");
mysql_close($link->handle); // dbx_close($link) would be better here
$link = dbx_connect(DBX_ODBC, "", "db", "username", "password", DBX_PERSISTENT)
or die("Could not connect");
echo "Connected successfully";
Always refer to the module-specific documentation as well.
See also dbx_close().