ibase_connect

(PHP 5, PHP 7 < 7.4.0)

ibase_connect — Abre uma conexão com um banco de dados

Descrição

ibase_connect(
    string $database = ?,
    string $username = ?,
    string $password = ?,
    string $charset = ?,
    int $buffers = ?,
    int $dialect = ?,
    string $role = ?,
    int $sync = ?
): resource

Estabelece uma conexão com um banco de dados Firebird/InterBase.

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/port:' (TCP/IP com servidor interbase em porta TCP customizada), '//hostname/' (NetBEUI), 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.

role

Funcional apenas com InterBase 5 e superior.

sync

Valor Retornado

Retorna um identificador de conexão Firebird/InterBase em caso de sucesso, ou false em caso de erro.

Erros/Exceções

Se você ter um erro parecido com "arithmetic exception, numeric overflow, or string truncation. Cannot transliterate character between character sets" (isto ocorre quando você tenta usar algum caractere com acento) ao usar esta função e depois de ibase_query() deve-se definir o conjunto de caracteres (isto é, ISO8859_1 ou o conjunto de caracteres atual).

Exemplos

Example #1 Exemplo de 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