XLVI. Firebird/InterBase

Introdução

Firebird/InterBase é um banco de dados relacional que oferecere a maioria da funcionalidade do ANSI SQL-92 que funciona no Linux, Windows, e uma variedade de plataformas Unix. Firebird/InterBase oferrece uma exelente concorencia, alta performance, e uma linguagem poderosa que suporta stored procedures e triggers. Ele é usado em sistemas de produção, sobre uma variedade de nomes deste 1981.

InterBase é o nome da variante de código fechado deste RDBMS que foi desenvolvido pela Borland/Inprise. maiores informações sobre o InterBase esta disponível em http://www.interbase.com/.

Firebird é um projeto comercialmente independente de programadores C e C++, conselheiros tecnicos e pessoal de suporte desenvolvendo e melhorando um banco de dados relacional, multi-plataforma baseado no código fonte liberado pela Inprise Corp (agora conhecido como Borland Software Corp) sobre InterBase Public License v.1.0 em 25 de Julho de 2000. Maiores informações sobre o Firebird esta disponível em http://www.firebirdsql.org/.

Nota: Esta extensão suporta InterBase versão 5 e posteriores e todas as versões do Firebird. Suporte para InterBase versão 5.x será deixado no PHP 5.

Este banco de dados usa aspas simples (') para escapar, um funcionamento semelhante ao do banco de dados Sybase, adicione ao seu php.ini a seguinte diretiva:

magic_quotes_sybase = On

Instalação

Para ativar o suporte InterBase, configure o PHP com --with-interbase[=DIR], aonde DIR é o diretório base da instalação do InterBase, o qual o padrão é /usr/interbase.

Nota para os usários de Win32: Para ativar este módulo em um ambiente Windows, você deverá copiar gds32.dll da pasta DLL do pacote binário PHP/Win32 para a pasta SYSTEM32 em seu computador com Windows. (Ex: C:\WINNT\SYSTEM32 or C:\WINDOWS\SYSTEM32). No caso de você já ter o sevidor de banco de dados InterBase na mesma máquina onde o PHP esta sendo executado, você já deve ter esta DLL. Então você não precisará copiar gds32.dll a partir da pasta DLL.

Configurações em execução

O comportamento dessas funções podem ser modificado pelas configurações do php.ini.

Tabela 1. Opções de configuração do InterBase

NomePadrãoModificável
ibase.allow_persistent"On"PHP_INI_SYSTEM
ibase.max_persistent"-1"PHP_INI_SYSTEM
ibase.max_links"-1"PHP_INI_SYSTEM
ibase.default_dbNULLPHP_INI_SYSTEM
ibase.default_userNULLPHP_INI_ALL
ibase.default_passwordNULLPHP_INI_ALL
ibase.default_charsetNULLPHP_INI_ALL
ibase.timestampformat"%Y-%m-%d %H:%M:%S"PHP_INI_ALL
ibase.dateformat"%Y-%m-%d"PHP_INI_ALL
ibase.timeformat"%H:%M:%S"PHP_INI_ALL
Para maiores detalhes e definição das constantes do PHP_INI_* veja ini_set().

Breve descrição das diretivas de configuração.

ibase.allow_persistent boolean

Quando permitir conexões persistentes ao Firebird/InterBase.

ibase.max_persistent integer

O número máximo de conexões persistentes com o Firebird/InterBase por processo. Novas conexões criadas com ibase_pconnect() não serão persistentes se este número for excedido.

ibase.max_links integer

O número máximo de conexões ao Firebird/InterBase por processo, incluindo as conexões persistentes.

ibase.default_db string

O banco de dados padrão a conectar quando ibase_[p]connect() é chamada sem especificar o nome do banco de dados. Se este valor for definido e o SQL safe mode estiver ativado, não serão permitidas outras conexões a este banco de dados.

ibase.default_user string

O nome de usuário para usar quando estiver se conectando ao banco de dados se não for especificado um nome de usuário.

ibase.default_password string

A senha usada ao conectar ao banco de dados se nenhuma senha for especificada.

ibase.default_charset string

O conjunto de caracteres a usar quando estiver conectando ao banco de dados se nenhum conjunto de caracteres for especificado.

ibase.timestampformat string

ibase.dateformat string

ibase.timeformat string

Estas diretivas são usadas para definir os formatos de data e hora que são usados ao retornas datas e horas do conjunto de resultados, ou quando estiver fornecendo datas e horas em parâmetros.

Constantes pré-definidas

As contantes abaixo são definidas por esta extensão e somente estarão disponíveis quando a extensão foi compilada com o PHP ou carregada dinamicamente durante a execução.

As seguinte constantes podem ser passadas para ibase_trans() para especificar o funcionamento da transação.

Tabela 2. Opções da transação Firebird/InterBase

ConstanteDescrição
IBASE_DEFAULT Serão usadas as definições padrão para a transação. Este padrão é determinado pela biblioteca do cliente, a qual define-o como IBASE_WRITE|IBASE_CONCURRENCY|IBASE_WAIT na maioria ds casos.
IBASE_READComeça uma transação apenas para leitura.
IBASE_WRITEComeça uma transação de leitura e escrita.
IBASE_CONSISTENCYComeça uma transação com o nível de isolação definido como 'consistency', o qual indica que a transação não pode ler de tabelas que estão sendo modificadas por outras transações concorrentes.
IBASE_CONCURRENCYComeça uma transação com o nível de isolação definido como 'concurrency' (ou 'snapshot'), o qual indica que a transação tem acesso a todas as tabelas, mas não pode ver as modificações que foram gravadas por outras transações após a transação ter começado.
IBASE_COMMITTEDComeça uma transação com o nível de isolação definido como 'read committed'. Esta opção deve ser combinada com IBASE_REC_VERSION ou IBASE_REC_NO_VERSION. Este nível de isolação permite acesso para as modifcações salvar após o início da transação. Se IBASE_REC_NO_VERSION for especificada, apenas a ultima versão de uma linha pode ser lida. Se IBASE_REC_VERSION for especificada, uma linha pode ser lida mesmo quando exista uma modificação pendente em uma transação concorrente.
IBASE_WAITIndica que uma transação deve esperar e tentar novamente quando aconteça um conflito.
IBASE_NOWAITIndica que a transação deve falhar imediatamente quando aconteça um conflito.

As seguintes constantes podem ser passadas para ibase_fetch_row(), ibase_fetch_assoc() ou ibase_fetch_object() para especificar o funcionamento para obter.

Tabela 3. Opções para obter do Firebird/InterBase

ConstanteDescrição
IBASE_FETCH_BLOBSTambém disponível como IBASE_TEXTpara compatibilidade com versões anteriores. Faz com que o conteúdo de campos BLOB serão retornados diretamente, ao invés de serem retornados como identificadores BLOB.
IBASE_FETCH_ARRAYSFaz com que as arrays sejam retornadas diretamente. Se não, são retornados identificadores de array. Identificadores de array somente podem ser usados como argumentos para operações INSERT, já que não estão disponíveis atualmente nenhuma função para manipular identificadores de array.
IBASE_UNIXTIMEFaz com que campos de date e time não sejam retornados como strings, mas como timestamps UNIX (o número de segundos deste epoch, o qual é 1-Jan-1970 0:00 UTC). Pode ser problematico se usado com datas antes de 1970 em alguns sistemas.

As seguintes constantes são usados para passar requesições e opções para as funções da API de serviços (ibase_server_info(), ibase_db_info (), ibase_backup(), ibase_restore () e ibase_maintain_db()). Por favor veja os manual do Firebird/InterBase para o significado destas opções.

IBASE_BKP_IGNORE_CHECKSUMS

IBASE_BKP_IGNORE_LIMBO

IBASE_BKP_METADATA_ONLY

IBASE_BKP_NO_GARBAGE_COLLECT

IBASE_BKP_OLD_DESCRIPTIONS

IBASE_BKP_NON_TRANSPORTABLE

IBASE_BKP_CONVERT

Options to ibase_backup()()

IBASE_RES_DEACTIVATE_IDX

IBASE_RES_NO_SHADOW

IBASE_RES_NO_VALIDITY

IBASE_RES_ONE_AT_A_TIME

IBASE_RES_REPLACE

IBASE_RES_CREATE

IBASE_RES_USE_ALL_SPACE

Options to ibase_restore()

IBASE_PRP_PAGE_BUFFERS

IBASE_PRP_SWEEP_INTERVAL

IBASE_PRP_SHUTDOWN_DB

IBASE_PRP_DENY_NEW_TRANSACTIONS

IBASE_PRP_DENY_NEW_ATTACHMENTS

IBASE_PRP_RESERVE_SPACE

IBASE_PRP_RES_USE_FULL

IBASE_PRP_RES

IBASE_PRP_WRITE_MODE

IBASE_PRP_WM_ASYNC

IBASE_PRP_WM_SYNC

IBASE_PRP_ACCESS_MODE

IBASE_PRP_AM_READONLY

IBASE_PRP_AM_READWRITE

IBASE_PRP_SET_SQL_DIALECT

IBASE_PRP_ACTIVATE

IBASE_PRP_DB_ONLINE

IBASE_RPR_CHECK_DB

IBASE_RPR_IGNORE_CHECKSUM

IBASE_RPR_KILL_SHADOWS

IBASE_RPR_MEND_DB

IBASE_RPR_VALIDATE_DB

IBASE_RPR_FULL

IBASE_RPR_SWEEP_DB

Opções para ibase_maintain_db()

IBASE_STS_DATA_PAGES

IBASE_STS_DB_LOG

IBASE_STS_HDR_PAGES

IBASE_STS_IDX_PAGES

IBASE_STS_SYS_RELATIONS

Opções para ibase_db_info()

IBASE_SVC_SERVER_VERSION

IBASE_SVC_IMPLEMENTATION

IBASE_SVC_GET_ENV

IBASE_SVC_GET_ENV_LOCK

IBASE_SVC_GET_ENV_MSG

IBASE_SVC_USER_DBPATH

IBASE_SVC_SVR_DB_INFO

IBASE_SVC_GET_USERS

Opções para ibase_server_info()

Índice
ibase_add_user --  Adiciona um usuário a um banco de dados seguro (apenas para IB6 ou posterior)
ibase_affected_rows --  Retorna o número de linhas que foram afetados pela consulta anterior
ibase_backup --  Initiates a backup task in the service manager and returns immediately
ibase_blob_add --  Adiciona dados em um blob recém criado
ibase_blob_cancel --  Cancela a criação de um blob
ibase_blob_close --  Fecha o blob
ibase_blob_create --  Cria um novo blob para adicionar dados
ibase_blob_echo --  Envia o conteúdo do blob para o browser
ibase_blob_get --  Retorna uma quantidade especificada de bytes de dados de um blob aberto
ibase_blob_import --  Cria um blob, copia um arquivo para ele e o fecha
ibase_blob_info --  Retorna o tamanho do blob e outras informações úteis
ibase_blob_open --  Abre um blob para obter partes de dados
ibase_close --  Fecha uma conexão com um banco de dados InterBase
ibase_commit_ret -- Grava uma transação sem fecha-la
ibase_commit -- Grava uma transação
ibase_connect --  Abre uma conexão com um banco de dados InterBase
ibase_db_info --  Request statistics about a database
ibase_delete_user --  Exclui um usuário de um banco de dados seguro (apenas para o IB6 ou posterior)
ibase_drop_db --  Exclui um banco de dados
ibase_errcode --  Retorna um código de erro
ibase_errmsg --  Retorna uma mensagem de erro
ibase_execute -- Executa uma consulta preparada anteriormente
ibase_fetch_assoc --  Obtém o resultado de uma linha da consulta como uma matriz associativa
ibase_fetch_object -- Obtém uma linha como um objeto de um banco de dados InterBase
ibase_fetch_row -- Obtém uma linha de um banco de dados InterBase
ibase_field_info --  Obtém informação sobre um campo
ibase_free_event_handler --  Cancela um manipulador de eventos registrado
ibase_free_query --  Libera a memória alocada para uma consulta preparada
ibase_free_result -- Libera um conjunto de resultados
ibase_gen_id --  Increments the named generator and returns its new value
ibase_maintain_db --  Execute a maintenance command on the database server
ibase_modify_user --  Modifica um usuário para um banco de dados seguro (somente para IB6 ou posterior)
ibase_name_result --  Define um nome para um conjunto de resultados
ibase_num_fields --  Obtém o número de campos em um conjunto de resultados
ibase_num_params --  Retorna o número de parâmetros em uma consulta preparada
ibase_param_info --  Retorna informação sobre um parâmetro em uma consulta preparada
ibase_pconnect --  Abre uma conexão persistente com um banco de dados InterBase
ibase_prepare --  Prepara uma consulta para execução posterior
ibase_query -- Executa uma consulta em um banco de dados InterBase
ibase_restore --  Initiates a restore task in the service manager and returns immediately
ibase_rollback_ret -- Desfaz uma transação sem fecha-la
ibase_rollback -- Desfaz uma transação
ibase_server_info --  Request information about a database server
ibase_service_attach --  Connect to the service manager
ibase_service_detach --  Disconnect from the service manager
ibase_set_event_handler --  Registra uma função de callback para ser chamada quando eventos são postados
ibase_timefmt --  Define o formato do timestamp, colunas do tipo data e hora retornadas de consultas
ibase_trans -- Inicia uma transação
ibase_wait_event --  Espera por um evento ser postado no banco de dados