(PHP 4 >= 4.0.6, PHP 5 <= 5.0.5, PECL dbx >= 1.1.0)
dbx_connect — Открывает соединение/базу данных
$module
, string $host
, string $database
, string $username
, string $password
[, int $persistent
] )Открывает соединение с базой данных.
module
Параметр module может быть как строкой, так и константой.
Предпочтение следует отдавать использованию константы. Возможные значения
перечислены ниже. Помните, что они будут работать только если соответствующее
расширение загружено.
DBX_MYSQL или "mysql"
DBX_ODBC или "odbc"
DBX_PGSQL или "pgsql"
DBX_MSSQL или "mssql"
DBX_FBSQL или "fbsql"
DBX_SYBASECT или "sybase_ct"
DBX_OCI8 или "oci8"
DBX_SQLITE или "sqlite"
hostХост, на котором запущен сервер баз данных
databaseимя базы данных
usernameИпя пользователя
passwordПароль
persistent
Если persistent задать как
DBX_PERSISTENT, то будет установлено постоянное
соединение.
Параметры host, database,
username и password
ожидаются, но не всегда используются в зависимости от функции соединения
конкретного расширения.
Возвращает объект в случае успеха, либо FALSE в обратном случае.
Если соединение было установлено, но база данных не выбрана, то
соединение будет закрыто и вернется FALSE.
Возвращенный объект object имеет три свойства:
Обработчик соединения. Его можно напрямую использовать в функциях расширения базы данных, в обход dbx.
<?php
$link = dbx_connect(DBX_MYSQL, "localhost", "db", "username", "password");
mysql_close($link->handle); // но лучше использовать dbx_close($link)
?>
| Версия | Описание |
|---|---|
| 5.0.0 |
Добавлена константа DBX_SQLITE.
|
| 4.3.0 |
Добавлена константа DBX_OCI8.
|
| 4.2.0 |
Добавлена константа DBX_SYBASECT.
|
| 4.1.0 |
Добавлена константа DBX_FBSQL.
|
Пример #1 Пример использования dbx_connect()
<?php
$link = dbx_connect(DBX_ODBC, "", "db", "username", "password", DBX_PERSISTENT)
or die("Could not connect");
echo "Connected successfully";
dbx_close($link);
?>
Замечание:
Всегда внимательно изучайте документацию по расширению для используемой базы данных.