<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>ibase_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="Firebird/InterBase"
HREF="ref.ibase.html"><LINK
REL="PREVIOUS"
TITLE="ibase_commit"
HREF="function.ibase-commit.html"><LINK
REL="NEXT"
TITLE="ibase_db_info"
HREF="function.ibase-db-info.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.ibase-commit.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.ibase-db-info.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.ibase-connect"
></A
>ibase_connect</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN52642"
></A
><P
> (PHP 3 >= 3.0.6, PHP 4, PHP 5)</P
>ibase_connect --
Abre uma conexão com um banco de dados InterBase
</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN52645"
></A
><H2
>Descrição</H2
>resource <B
CLASS="methodname"
>ibase_connect</B
> ( [string database [, string username [, string password [, string charset [, int buffers [, int dialect [, string role [, int sync]]]]]]]] )<BR
></BR
><P
> Estabelece uma conexão com um servidor InterBase.
O parâmetro <CODE
CLASS="parameter"
>database</CODE
> deve ser um caminho válido
para o arquivo de banco de dados no servidor no qual ele reside.
Se o servidor não é local, deve ser prefixado por
'hostname:' (TCP/IP), '//hostname/' (NetBEUI) or 'hostname@' (IPX/SPX),
dependendo do protocolo de conexão utilizado. <CODE
CLASS="parameter"
>username</CODE
>
e <CODE
CLASS="parameter"
>password</CODE
> também podem ser espeficicados com as diretivas
de configuração do PHP ibase.default_user e ibase.default_password.
<CODE
CLASS="parameter"
>charset</CODE
> é o conjunto de caracteres padrão para o banco de dados.
<CODE
CLASS="parameter"
>buffers</CODE
> é o número de buffers de banco de dados para
alocar para cache do lado do servidor. Se 0 ou omitido, o servidor escolherá o
seu próprio padrão. <CODE
CLASS="parameter"
>dialect</CODE
> seleciona o dialeto padrão para
todos os comandos SQL executados na conexão, e o padrão é
o maior que seja suportado pelas bibliotecas do cliente.
</P
><P
> No caso de executar novamente
<B
CLASS="function"
>ibase_connect()</B
> com os mesmos argumentos, não será estabilizada
uma nova conexão, mas ao invés, o identificador de conexão que já esta aberta
será retornada. A conexão com o servidor será fechada assim que assim que termine a
execução do script, a menos que seja fechada anteriormente usando
a função <A
HREF="function.ibase-close.html"
><B
CLASS="function"
>ibase_close()</B
></A
>.
<TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN52684"
></A
><P
><B
>Exemplo 1. Exemplo <B
CLASS="function"
>ibase_connect()</B
></B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br /> $host </font><font color="#007700">= </font><font color="#DD0000">'localhost:/path/to/your.gdb'</font><font color="#007700">;<br /><br /> </font><font color="#0000BB">$dbh </font><font color="#007700">= </font><font color="#0000BB">ibase_connect</font><font color="#007700">(</font><font color="#0000BB">$host</font><font color="#007700">, </font><font color="#0000BB">$username</font><font color="#007700">, </font><font color="#0000BB">$password</font><font color="#007700">);<br /> </font><font color="#0000BB">$stmt </font><font color="#007700">= </font><font color="#DD0000">'SELECT * FROM tblname'</font><font color="#007700">;<br /> </font><font color="#0000BB">$sth </font><font color="#007700">= </font><font color="#0000BB">ibase_query</font><font color="#007700">(</font><font color="#0000BB">$dbh</font><font color="#007700">, </font><font color="#0000BB">$stmt</font><font color="#007700">);<br /> while (</font><font color="#0000BB">$row </font><font color="#007700">= </font><font color="#0000BB">ibase_fetch_object</font><font color="#007700">(</font><font color="#0000BB">$sth</font><font color="#007700">)) {<br /> echo </font><font color="#0000BB">$row</font><font color="#007700">-></font><font color="#0000BB">email</font><font color="#007700">, </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /> }<br /> </font><font color="#0000BB">ibase_free_result</font><font color="#007700">(</font><font color="#0000BB">$sth</font><font color="#007700">);<br /> </font><font color="#0000BB">ibase_close</font><font color="#007700">(</font><font color="#0000BB">$dbh</font><font color="#007700">);<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
O parâmetro opcional <CODE
CLASS="parameter"
>buffers</CODE
> foi adicionado no PHP 4.0.0.
</P
></BLOCKQUOTE
></DIV
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
O parâmetro opcional <CODE
CLASS="parameter"
>dialect</CODE
> foi adicionado no PHP
4.0.0 e somente funciona com o InterBase 6 ou superior.
</P
></BLOCKQUOTE
></DIV
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
O parâmetro opcional <CODE
CLASS="parameter"
>role</CODE
> foi adicionado no PHP
4.0.0 e somente funciona com o InterBase 5 ou superior.
</P
></BLOCKQUOTE
></DIV
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
Se você tiver um erro como "arithmetic exception, numeric overflow,
or string truncation. Cannot transliterate character between character
sets" (isto acontece quando você tenta usar alguns caracteres com acentos)
quando você utilizar esta e depois <A
HREF="function.ibase-query.html"
><B
CLASS="function"
>ibase_query()</B
></A
> você deverá
definir o conjunto de caracteres (ex. ISO8859_1 ou seu conjunto de caraacteres atual).
</P
></BLOCKQUOTE
></DIV
><P
> Veja também
<A
HREF="function.ibase-pconnect.html"
><B
CLASS="function"
>ibase_pconnect()</B
></A
> e
<A
HREF="function.ibase-close.html"
><B
CLASS="function"
>ibase_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.ibase-commit.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.ibase-db-info.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>ibase_commit</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.ibase.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>ibase_db_info</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
