<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >dbx_connect</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="funções dbx" HREF="ref.dbx.html"><LINK REL="PREVIOUS" TITLE="dbx_compare" HREF="function.dbx-compare.html"><LINK REL="NEXT" TITLE="dbx_error" HREF="function.dbx-error.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=UTF-8"></HEAD ><BODY CLASS="refentry" 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.dbx-compare.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-error.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.dbx-connect" ></A >dbx_connect</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN32269" ></A ><P > (PHP 4 >= 4.0.6, PHP 5 <= 5.0.4)</P >dbx_connect -- Inicia uma conexão/banco de dados</DIV ><DIV CLASS="refsect1" ><A NAME="AEN32272" ></A ><H2 >Descrição</H2 >objeto <B CLASS="methodname" >dbx_connect</B > ( mixed módulo, string servidor, string banco de dados, string nome de usuário, string senha [, int persistente] )<BR ></BR ><P > A função <B CLASS="function" >dbx_connect()</B > retorna um objeto quando realizada com sucesso ou <TT CLASS="constant" ><B >FALSE</B ></TT > ao falhar. Se uma conexão é realizada mas o banco de dados não foi selecionado, a conexão é fechada e retorna <TT CLASS="constant" ><B >FALSE</B ></TT >. O parâmetro <CODE CLASS="parameter" >persistente</CODE > pode ser setado na constante <TT CLASS="constant" ><B >DBX_PERSISTENT</B ></TT >, caso isto seja feito, uma conexão persistente será criada automaticamente. </P ><P > O parâmetro <CODE CLASS="parameter" >módulo</CODE > pode ser uma "string" ou uma constante, apesar da segunda forma ser a mais adequada. Os possíveis valres são listados abaixo, mas tenha em mente que eles somente irão funcionar se o módulo atual está carregado. </P ><P > <P ></P ><UL ><LI ><P > <TT CLASS="constant" ><B >DBX_MYSQL</B ></TT > ou "mysql" </P ></LI ><LI ><P > <TT CLASS="constant" ><B >DBX_ODBC</B ></TT > ou "odbc" </P ></LI ><LI ><P > <TT CLASS="constant" ><B >DBX_PGSQL</B ></TT > ou "pgsql" </P ></LI ><LI ><P > <TT CLASS="constant" ><B >DBX_MSSQL</B ></TT > ou "mssql" </P ></LI ><LI ><P > <TT CLASS="constant" ><B >DBX_FBSQL</B ></TT > ou "fbsql" (disponível à partir do PHP 4.1.0) </P ></LI ><LI ><P > <TT CLASS="constant" ><B >DBX_SYBASECT</B ></TT > ou "sybase_ct" (disponível à partir do PHP 4.2.0) </P ></LI ><LI ><P > <TT CLASS="constant" ><B >DBX_OCI8</B ></TT > ou "oci8" (disponível à partir do PHP 4.3.0) </P ></LI ><LI ><P > <TT CLASS="constant" ><B >DBX_SQLITE</B ></TT > ou "sqlite" (somente no cvs) </P ></LI ></UL > </P ><P > O parâmetro <CODE CLASS="parameter" >servidor</CODE >, <CODE CLASS="parameter" >banco de dados</CODE >, <CODE CLASS="parameter" >nome de usuário</CODE > e <CODE CLASS="parameter" >senha</CODE > são necessários, porém nem sempre usados depedendo das funções de conexão do módulo selecionado. </P ><P > O <CODE CLASS="varname" >objeto</CODE > retornado contém três propriedades: <P ></P ><DIV CLASS="variablelist" ><DL ><DT ><SPAN CLASS="property" >banco de dados</SPAN ></DT ><DD ><P > É o nome do banco de dados selecionado. </P ></DD ><DT ><SPAN CLASS="property" >evento</SPAN ></DT ><DD ><P > É um evento válido para o banco de dados conectado, e como tal pode ser usado nas funções do módulo-específico (se necessário). <DIV CLASS="informalexample" ><P ></P ><A NAME="AEN32347" ></A ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br />$link </font><font color="#007700">= </font><font color="#0000BB">dbx_connect </font><font color="#007700">(</font><font color="#0000BB">DBX_MYSQL</font><font color="#007700">, </font><font color="#DD0000">"localhost"</font><font color="#007700">, </font><font color="#DD0000">"bd"</font><font color="#007700">, </font><font color="#DD0000">"nome de usuário"</font><font color="#007700">, </font><font color="#DD0000">"senha"</font><font color="#007700">);<br /></font><font color="#0000BB">mysql_close </font><font color="#007700">(</font><font color="#0000BB">$link</font><font color="#007700">-></font><font color="#0000BB">handle</font><font color="#007700">); </font><font color="#FF8000">// dbx_close($link) seria o mais apropiado<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ><P ></P ></DIV > </P ></DD ><DT ><SPAN CLASS="property" >módulo</SPAN ></DT ><DD ><P > É usado internamente pelo dbx, e é atualmente o número do módulo mencionado acima. </P ></DD ></DL ></DIV > </P ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN32355" ></A ><P ><B >Exemplo 1. <B CLASS="function" >dbx_connect()</B > exemplo</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br />$link </font><font color="#007700">= </font><font color="#0000BB">dbx_connect </font><font color="#007700">(</font><font color="#0000BB">DBX_ODBC</font><font color="#007700">, </font><font color="#DD0000">""</font><font color="#007700">, </font><font color="#DD0000">"bd"</font><font color="#007700">, </font><font color="#DD0000">"nome de usuário"</font><font color="#007700">, </font><font color="#DD0000">"senha"</font><font color="#007700">, </font><font color="#0000BB">DBX_PERSISTENT</font><font color="#007700">)<br /> or die (</font><font color="#DD0000">"Não foi possível conectar"</font><font color="#007700">);<br /><br />print (</font><font color="#DD0000">"Conexão realizada com sucesso."</font><font color="#007700">);<br /></font><font color="#0000BB">dbx_close </font><font color="#007700">(</font><font color="#0000BB">$link</font><font color="#007700">);<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > <DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Sempre se referia à documentação do módulo-específico quando necessário. </P ></BLOCKQUOTE ></DIV > </P ><P > Veja também <A HREF="function.dbx-close.html" ><B CLASS="function" >dbx_close()</B ></A >. </P ></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.dbx-compare.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-error.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >dbx_compare</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.dbx.html" ACCESSKEY="U" >Acima</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >dbx_error</TD ></TR ></TABLE ></DIV ></BODY ></HTML >