dbx_connect

(PHP 4 >= 4.0.6, PHP 5)

dbx_connect -- Inicia uma conexão/banco de dados

Descrição

objeto dbx_connect ( mixed módulo, string servidor, string banco de dados, string nome de usuário, string senha [, int persistente] )

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.

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:

banco de dados

É o nome do banco de dados selecionado.

evento

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

<?php
$link
= dbx_connect (DBX_MYSQL, "localhost", "bd", "nome de usuário", "senha");
mysql_close ($link->handle); // dbx_close($link) seria o mais apropiado
?>

módulo

É usado internamente pelo dbx, e é atualmente o número do módulo mencionado acima.

Exemplo 1. dbx_connect() exemplo

<?php
$link
= dbx_connect (DBX_ODBC, "", "bd", "nome de usuário", "senha", DBX_PERSISTENT)
    or die (
"Não foi possível conectar");

print (
"Conexão realizada com sucesso.");
dbx_close ($link);
?>

Nota: Sempre se referia à documentação do módulo-específico quando necessário.

Veja também dbx_close().