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().