Forum und email
dbx
PHP Manual

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

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.

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

dbx
PHP Manual