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.
dbx.colnames_case
stringOs 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.