Manual do PHP
Anterior |  | Próxima

# dbx_connect

(PHP 4 >= 4.0.6, PHP 5 <= 5.0.4)

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.

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

Anterior | Principal | Próxima
dbx_compare | Acima | dbx_error