<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>funções dbx</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Manual do PHP"
HREF="index.html"><LINK
REL="UP"
TITLE="Referência das Funções"
HREF="funcref.html"><LINK
REL="PREVIOUS"
TITLE="dbmreplace"
HREF="function.dbmreplace.html"><LINK
REL="NEXT"
TITLE="dbx_close"
HREF="function.dbx-close.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="reference"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Manual do PHP</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.dbmreplace.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.dbx-close.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="reference"
><A
NAME="ref.dbx"
></A
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="title"
>XXVII. funções dbx</H1
><DIV
CLASS="PARTINTRO"
><A
NAME="AEN31980"
></A
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="dbx.intro"
>Introdução</A
></H1
><P
> 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.
</P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="dbx.required"
>Dependências</A
></H1
><P
> 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:
<P
></P
><UL
><LI
><P
> <A
HREF="ref.fbsql.html"
>FrontBase</A
> (disponível à partir do PHP 4.1.0).
</P
></LI
><LI
><P
> <A
HREF="ref.mssql.html"
>Microsoft SQL Server</A
>
</P
></LI
><LI
><P
> <A
HREF="ref.mysql.html"
>MySQL</A
>
</P
></LI
><LI
><P
> <A
HREF="ref.odbc.html"
>ODBC</A
>
</P
></LI
><LI
><P
> <A
HREF="ref.pgsql.html"
>PostgreSQL</A
>
</P
></LI
><LI
><P
> <A
HREF="ref.sybase.html"
>Sybase-CT</A
> (disponível à partir do PHP 4.2.0).
</P
></LI
><LI
><P
> <A
HREF="ref.oci8.html"
>Oracle (oci8)</A
> (disponível à partir do PHP 4.3.0).
</P
></LI
><LI
><P
> <A
HREF="ref.sqlite.html"
>SQLite</A
> (somente via cvs).
</P
></LI
></UL
>
</P
><P
> A documentação para adicionar suporte ao banco de dados no dbx pode
ser encontrada em <A
HREF="http://www.guidance.nl/php/dbx/doc/"
TARGET="_top"
>http://www.guidance.nl/php/dbx/doc/</A
>.
</P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="dbx.installation"
>Instalação</A
></H1
><P
> Para ter estas funções disponíveis, você precisa compilar o PHP com
suporte à dbx usando a opção <CODE
CLASS="option"
>--enable-dbx</CODE
>
e todas as opções para o banco de dados que será usado, ex: para o MySQL
você deve especificar <CODE
CLASS="option"
>--with-mysql=[DIR]</CODE
>.
Para que outros banco de dados tenham suporte ao módulo-dbx consulte o
manual do seu banco de dados.
</P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="dbx.configuration"
>Configurações em execução</A
></H1
><P
> O comportamento dessas funções podem ser modificado pelas configurações do <TT
CLASS="filename"
>php.ini</TT
>.
</P
><P
> <DIV
CLASS="table"
><A
NAME="AEN32024"
></A
><P
><B
>Tabela 1. Opções de Configuração do DBX</B
></P
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><COL><COL><COL><THEAD
><TR
><TH
>Nome</TH
><TH
>Padrão</TH
><TH
>Changeable</TH
></TR
></THEAD
><TBODY
><TR
><TD
>dbx.colnames_case</TD
><TD
>"unchanged"</TD
><TD
>PHP_INI_SYSTEM</TD
></TR
></TBODY
></TABLE
></DIV
>
Para mais detalhes e definições das constantes PHP_INI_* veja
<A
HREF="function.ini-set.html"
><B
CLASS="function"
>ini_set()</B
></A
>.
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
Esta opção-ini está disponível à partir do PHP 4.3.0.
</P
></BLOCKQUOTE
></DIV
><P
>Breve descrição das
diretivas de configuração.</P
><P
> <P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><A
NAME="ini.dbx.colnames-case"
></A
><CODE
CLASS="parameter"
>dbx.colnames_case</CODE
>
<A
HREF="language.types.string.html"
><B
CLASS="type"
>string</B
></A
></DT
><DD
><P
> 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 <A
HREF="function.dbx-query.html"
><B
CLASS="function"
>dbx_query()</B
></A
>.
</P
></DD
></DL
></DIV
>
</P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="dbx.resources"
>Tipos Resource</A
></H1
><P
> 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.
</P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="constants.dbx"
>Constantes pré-definidas</A
></H1
><P
> 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.
</P
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><TT
CLASS="constant"
><B
>DBX_MYSQL</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_ODBC</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_PGSQL</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_MSSQL</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_FBSQL</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_OCI8</B
></TT
>
(inteiro) (disponível à partir do PHP 4.3.0)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_SYBASECT</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_SQLITE</B
></TT
>
(inteiro) (somente via cvs)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_PERSISTENT</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_RESULT_INFO</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_RESULT_INDEX</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_RESULT_ASSOC</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_RESULT_UNBUFFERED</B
></TT
>
(inteiro) (somente via CVS)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_COLNAMES_UNCHANGED</B
></TT
>
(inteiro) (disponível à partir do PHP 4.3.0)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_COLNAMES_UPPERCASE</B
></TT
>
(inteiro) (disponível à partir do PHP 4.3.0)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_COLNAMES_LOWERCASE</B
></TT
>
(inteiro) (disponível à partir do PHP 4.3.0)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_CMP_NATIVE</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_CMP_TEXT</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_CMP_NUMBER</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_CMP_ASC</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DBX_CMP_DESC</B
></TT
>
(inteiro)</DT
><DD
><P
>
</P
></DD
></DL
></DIV
></DIV
></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Índice</B
></DT
><DT
><A
HREF="function.dbx-close.html"
>dbx_close</A
> -- Encera uma conexão/banco de dados</DT
><DT
><A
HREF="function.dbx-compare.html"
>dbx_compare</A
> -- Compara duas linhas para finalidades de ordenação</DT
><DT
><A
HREF="function.dbx-connect.html"
>dbx_connect</A
> -- Inicia uma conexão/banco de dados</DT
><DT
><A
HREF="function.dbx-error.html"
>dbx_error</A
> --
Mostra a mensagem de erro da última função chamada no módulo (não apenas na conexão).
</DT
><DT
><A
HREF="function.dbx-escape-string.html"
>dbx_escape_string</A
> --
Transforma uma string para que ela possa ser seguramente usada em comandos-sql.
</DT
><DT
><A
HREF="function.dbx-fetch-row.html"
>dbx_fetch_row</A
> -- Lê as linhas do resultado de uma requisição que tem a flag
<TT
CLASS="constant"
><B
>DBX_RESULT_UNBUFFERED</B
></TT
> ligada</DT
><DT
><A
HREF="function.dbx-query.html"
>dbx_query</A
> -- Envia uma requisição e armazena todos os resultados (se houver)</DT
><DT
><A
HREF="function.dbx-sort.html"
>dbx_sort</A
> --
Ordena um resultado de uma dbx_query usando uma função pré-definida
</DT
></DL
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.dbmreplace.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Principal</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.dbx-close.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>dbmreplace</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="funcref.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>dbx_close</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
