A função dbx_connect() retorna um objeto quando realizada com sucesso ou
FALSE ao falhar. Se uma conexão é realizada mas o banco de dados não foi selecionado,
a conexão é fechada e retorna FALSE. O parâmetro persistente
pode
ser setado na constante DBX_PERSISTENT, caso isto seja feito, uma conexão
persistente será criada automaticamente.
O parâmetro módulo
pode ser uma "string" ou uma constante,
apesar da segunda forma ser a mais adequada. Os possíveis valres são listados abaixo,
mas tenha em mente que eles somente irão funcionar se o módulo atual está carregado.
DBX_MYSQL ou "mysql"
DBX_ODBC ou "odbc"
DBX_PGSQL ou "pgsql"
DBX_MSSQL ou "mssql"
DBX_FBSQL ou "fbsql" (disponível à partir do PHP 4.1.0)
DBX_SYBASECT ou "sybase_ct" (disponível à partir do PHP 4.2.0)
DBX_OCI8 ou "oci8" (disponível à partir do PHP 4.3.0)
DBX_SQLITE ou "sqlite" (somente no cvs)
O parâmetro servidor
, banco de dados
,
nome de usuário
e senha
são necessários,
porém nem sempre usados depedendo das funções de conexão do módulo selecionado.
O objeto
retornado contém três propriedades:
É o nome do banco de dados selecionado.
É um evento válido para o banco de dados conectado, e como tal pode ser usado nas funções do módulo-específico (se necessário).
É usado internamente pelo dbx, e é atualmente o número do módulo mencionado acima.
Nota: Sempre se referia à documentação do módulo-específico quando necessário.
Veja também dbx_close().