Учебник РНР
Назад Вперёд

dbx_connect

(PHP 4 >= 4.0.6)

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

Описание

object dbx_connect (mixed module, string host, string database, string username, string password [, int persistent])

dbx_connect() возвращает объект при успехе, FALSE при ошибке. Если соединение установлено, но БД не может быть выбрана, соединение закрывается и возвращается FALSE. Параметр persistent может быть установлен для DBX_PERSISTENT, и в этом случае создаётся постоянное/persistent соединение.

Параметр module может быть строкой или константой, хотя вторая предпочтительней. Возможные значения даны ниже, но помните, что они работают только в том случае, если модуль реально загружен.

  • DBX_MYSQL или "mysql"

  • DBX_ODBC или "odbc"

  • DBX_PGSQL или "pgsql"

  • DBX_MSSQL или "mssql"

  • DBX_FBSQL или "fbsql" (начиная с PHP 4.1.0)

  • DBX_SYBASECT или "sybase_ct" (начиная с PHP 4.2.0)

Параметры host, database, username и password ожидаются, но не всегда используются, так как это зависит от функций соединения для абстрактного модуля.

Возвращаемый object имеет три свойства:

database

Это имя выбранной в данный момент БД.

handle

Это верный дескриптор для соединённой БД, и как таковой он может использоваться в функциях, специфичных для модуля (если это необходимо).
$link = dbx_connect (DBX_MYSQL, "localhost", "db", "username", "password");
mysql_close ($link->handle); // dbx_close($link) было бы лучше

Оно используется внутренне только в dbx и в настоящее время является номером модуля, упомянутом ранее.

Пример 1. dbx_connect()
<?php
$link = dbx_connect (DBX_ODBC, "", "db", "username", "password", DBX_PERSISTENT)
    or die ("Could not connect");

print ("Connected successfully");
dbx_close ($link);
?>

Примечание: не забывайте также всегда обращаться к документации модуля.

См. также: dbx_close().


Назад Оглавление Вперёд
dbx_compare Вверх dbx_error