phpm.ru | Открывает соединение/базу данных

Описание

dbx_connect ( mixed $module , string $host , string $database , string $username , string $password , int $persistent = ? ) : object

Открывает соединение с базой данных.

Список параметров

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 имеет три свойства:

database

Имя выбранной базы данных.

handle

Обработчик соединения. Его можно напрямую использовать в функциях модуля базы данных, в обход dbx.


<?php
$link = dbx_connect(DBX_MYSQL, "localhost", "db", "username", "password");
mysql_close($link->handle); // но лучше использовать dbx_close($link)
?>

module

Используется для внутренних нужд dbx. Фактически является номером модуля, которые перечислены выше.

Примеры

Пример #1 Пример использования dbx_connect()


<?php
$link = dbx_connect(DBX_ODBC, "", "db", "username", "password", DBX_PERSISTENT)
    or die("Не получилось подключиться");

echo "Успешно подключен";
dbx_close($link);
?>

Примечания

Замечание:
Всегда внимательно изучайте документацию модуля для используемой базы данных.

Смотрите также

dbx_close() - Закрыть открытое соединение/базу данных