dbx_connect

(PHP 4 >= 4.0.6, PHP 5 < 5.1.0, PECL dbx >= 1.1.0)

dbx_connectОткрывает соединение/базу данных

Описание

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() - Закрыть открытое соединение/базу данных