O módulo dbx é uma camada de banco de dados abstrata (db 'X', onde 'X' é o banco de dados suportado). As funções dbx permitem à você acessar todos os banco de dados suportados usando uma única convenção de chamada. As próprias funções-dbx não atuam diretamente com os bancos de dados, mas sim nos módulos que são usados para suportar estes banco de dados.
Para poder usar o banco de dados com o módulo-dbx, o módulo precisa estar linkado ou carregado no PHP, e o módulo do banco de dados precisa ser suportado pelo módulo-dbx. Atualmente, os seguintes banco de dados são suportados, mas haverão mais:
FrontBase (disponível à partir do PHP 4.1.0).
Sybase-CT (disponível à partir do PHP 4.2.0).
Oracle (oci8) (disponível à partir do PHP 4.3.0).
SQLite (somente via cvs).
A documentação para adicionar suporte ao banco de dados no dbx pode ser encontrada em http://www.guidance.nl/php/dbx/doc/.
Para ter estas funções disponíveis, você precisa compilar o PHP com suporte à dbx usando a opção --enable-dbx e todas as opções para o banco de dados que será usado, ex: para o MySQL você deve especificar --with-mysql=[DIR]. Para que outros banco de dados tenham suporte ao módulo-dbx consulte o manual do seu banco de dados.
O comportamento dessas funções podem ser modificado pelas configurações do php.ini.
Tabela 1. Opções de Configuração do DBX
Nome | Padrão | Changeable |
---|---|---|
dbx.colnames_case | "unchanged" | PHP_INI_SYSTEM |
Nota: Esta opção-ini está disponível à partir do PHP 4.3.0.
Breve descrição das diretivas de configuração.
Os nomes das colunas podem ser retornados "inalterados" ou convertidos para "caixa alta" ou "caixa baixa". Esta diretiva pode ser sobreescrita alterando a "flag" de dbx_query().
Há dois tipos de recursos usados no módulo dbx. O primeiro é um link-objeto para a conexão com o banco de dados, e o segundo é o resultado-objeto que guarda o resultado da consulta.
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.