dbx_connect
(PHP 4 >= 4.0.6, PHP 5 <= 5.0.5, PECL dbx:1.1.0)
dbx_connect — Inicia uma conexão/banco de dados
Descrição
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:
- 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.
Example#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().