(PHP 4 >= 4.0.6, PHP 5 < 5.1.0, PECL dbx >= 1.1.0)
dbx_connect — Inicia uma conexão/banco de dados
$module
, string $host
, string $database
, string $username
, string $password
[, int $persistent
] ) : objetoAbre uma conexão para o banco de dados.
module
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" (PHP 5)
hostO host do servidor SQL
databaseO nome do banco de dados
usernameO nome de usuário
passwordA senha
persistent
O parâmetro persistent pode ser definido para
DBX_PERSISTENT, dessa forma, a conexão persistente
será criada.
Os parâmetros host, database,
username e password são necessários,
porém nem sempre usados depedendo das funções de conexão do módulo selecionado.
Retorna um objeto em sucesso, FALSE em erro. Se uma conexão foi feita
mas o banco de dados não foi selecionado, a conexão é fechada e
FALSE é retornado.
O objeto retornado contém três propriedades:
É 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
?>
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");
echo "Conexão realizada com sucesso.";
dbx_close ($link);
?>
Nota:
Sempre se referia à documentação do módulo-específico quando necessário.