ibase_connect
(PHP 5, PHP 7 < 7.4.0)
ibase_connect — Abre uma conexão com um banco de dados InterBase
Descrição
ibase_connect(
string $database
= ?,
string $username
= ?,
string $password
= ?,
string $charset
= ?,
int $buffers
= ?,
int $dialect
= ?,
string $role
= ?,
int $sync
= ?
): resource
No caso de uma segunda chamada a ibase_connect() com
os mesmos argumntos, não será criada uma nova conexão, mas ao invés, será
retornado o identificador da conexão já aberta. A conexão com
o servidor será fechada assim que terminar a execução do script, a menos
que seja fechada explicitamente pela chamada de ibase_close().
Parâmetros
-
database
-
O argumento database
deve ser um caminho válido
para o arquivo do banco de dados no servidor no qual ele reside. Se o servidor não for local,
ele deve ser prefixado com 'hostname:' (TCP/IP), '//hostname/'
(NetBEUI) ou 'hostname@' (IPX/SPX), dependendo do protocolo de conexão
usado.
-
username
-
O nome de usuário. Pode ser definido com a diretiva
ibase.default_user
do php.ini
-
password
-
A senha para username
. Poe ser definida com a diretiva
ibase.default_password
do php.ini.
-
charset
-
charset
é o conjunto de caracteres padrão
para o banco de dados.
-
buffers
-
buffers
é o número de buffers do banco de dados
a serem alocados para o cache do lado do servidor. Se 0 ou omitido, o servidor
escolhe o seu próprio padrão.
-
dialect
-
dialect
define o dialeto SQL padrão para
qualquer comand executado na conexão, e o padrão é o mais alto
suportado pelas bibliotecas do cliente. Funciona apenas com
InterBase 6 e superior.
-
role
-
Funcional apenas com InterBase 5 e superior.
-
sync
-
Valor Retornado
Retorna um identificador de conexão InterBase em caso de sucesso, ou false
em caso de erro.
Erros
Se você ter um erro parecido com "arithmetic exception, numeric overflow, ou
string truncation. Cannot transliterate character between character sets"
(isto ocorre quando você tenta usar algum caractere com acento) ao usar esta e depois
ibase_query() você deve definir seu conjunto de caracteres
(ex. ISO8859_1 ou seu conjunto de caracteres atual).
Exemplos
Exemplo #1 Exemplo ibase_connect()
<?php
$host = 'localhost:/path/to/your.gdb';
$dbh = ibase_connect($host, $username, $password);
$stmt = 'SELECT * FROM tblname';
$sth = ibase_query($dbh, $stmt);
while ($row = ibase_fetch_object($sth)) {
echo $row->email, "\n";
}
ibase_free_result($sth);
ibase_close($dbh);
?>
Veja Também
- ibase_pconnect() - Abre uma conexão persistente com um banco de dados InterBase
- ibase_close() - Fecha uma conexão com um banco de dados InterBase