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

	po gonn © 2005 "JULI'S BEEHIVE"