Funções para Firebird/InterBase
PHP Manual

ibase_pconnect

(PHP 4, PHP 5)

ibase_pconnectAbre uma conexão persistente com um banco de dados InterBase

Descrição

resource ibase_pconnect ([ string $database [, string $username [, string $password [, string $charset [, int $buffers [, int $dialect [, string $role [, int $sync ]]]]]]]] )

Abre uma conexão persistente com um banco de dados InterBase

ibase_pconnect() aje muito parecido com ibase_connect() com duas diferenças maiores.

Primeiro, ao conectar, a função irá primeiro tentar encontrar uma conexão (persistente) que já esteja aberta com os mesmos parâmetros. Se uma for encontrada, um identidicador para ela será retornado ao invés de abrir uma nova conexão.

Segundo, a conexão ao servidor InterBase não será fechada quando a execução do script terminar. Ao invés, a conexão permanecerá aberta para uso futuro ( ibase_close() não irá fechar conexões criadas por ibase_pconnect()). Este tipo de conexão é então chamado de "persistente".

Parâmetros

database

O argumento database deve ser um caminho válido para o arquivo do banco de dados no sevidor no qual 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. Pode 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 buffer do banco de dados a serem alocados para o cache do lado do servidor. Se for 0 ou omitido, o servidor escolhe 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 o InterBase 5 e posterior.

sync

Valor Retornado

Retorna um identificador de conexão InterBase em caso de sucesso, ou FALSE em caso de erro.

Changelog

Versão Descrição
4.0.0 Os parâmetros buffers, dialect e role foram adicionados

Veja Também


Funções para Firebird/InterBase
PHP Manual