dbx_compare
dbx_error
Funções da 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 `$module` , string `$host` , string `$database` , string `$username` , string `$password` [, int `$persistent` ] )

Abre uma conexão para o banco de dados.

### Parâmetros

`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)

`host`

  O host do servidor SQL

`database`

  O nome do banco de dados

`username`

  O nome de usuário

`password`

  A 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.

### Valor Retornado

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:

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.

### Exemplos

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);
?>`

### Notas

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

### Veja Também

- dbx_close() - Encera uma conexão/banco de dados

dbx_compare
dbx_error
Funções da dbx
PHP Manual