Sophie: php-manual-pt_BR-5.2.4-1mdv2008.1 noarch

php-manual-pt_BR-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>mysqli_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="MySQL Melhorada"
HREF="ref.mysqli.html"><LINK
REL="PREVIOUS"
TITLE="mysqli_connect_error"
HREF="function.mysqli-connect-error.html"><LINK
REL="NEXT"
TITLE="mysqli_data_seek"
HREF="function.mysqli-data-seek.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.mysqli-connect-error.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.mysqli-data-seek.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.mysqli-connect"
></A
>mysqli_connect</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN133266"
></A
><P
>    (PHP 5)</P
>mysqli_connect<P
>    (no version information, might be only in CVS)</P
>mysqli()&nbsp;--&nbsp;Abre uma nova conexão com o servidor MySQL</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN133270"
></A
><H2
>Descrição</H2
><P
>Estilo de procedimento</P
>object <B
CLASS="methodname"
>mysqli_connect</B
> ( [string host [, string username [, string passwd [, string dbname [, int port [, string socket]]]]]] )<BR
></BR
><P
>Estilo orientado a objeto (construtor):</P
>class <B
CLASS="classname"
>mysqli</B
> { <BR
></BR
><B
CLASS="methodname"
>__construct</B
> ( [string host [, string username [, string passwd [, string dbname [, int port [, string socket]]]]]] )<BR
></BR
>}<P
>&#13;     A função <B
CLASS="function"
>mysqli_connect()</B
> tenta abrir uma conexão com o servidor MySQL
     que esteja rodando em <CODE
CLASS="parameter"
>host</CODE
> o qual pode ser um nome de servidor ou um endereço IP. Passando
     <TT
CLASS="constant"
><B
>NULL</B
></TT
> ou a string "localhost" para este parâmetro, é assumido o servidor local. Quando possível,
     serão usados pipes ao invés do protocolo TCP/IP. Se for bem sucedida, a função <B
CLASS="function"
>mysqli_connect()</B
>
     irá retornar um objeto representando a conexão com o banco de dados, ou <TT
CLASS="constant"
><B
>FALSE</B
></TT
> em caso de falha.
    </P
><P
>&#13;     Os parâmetros <CODE
CLASS="parameter"
>username</CODE
> e <CODE
CLASS="parameter"
>password</CODE
> especificam o
     nome de usuário e a senha para usar ao conectar com o servidor MySQL. Se a senha não for dada
     (é passado o valor <TT
CLASS="constant"
><B
>NULL</B
></TT
>), the MySQL server will attempt to authenticate the user against those
     user records which have no password only. This allows one username to be used with different
     permissions (depending on if a password as provided or not).
    </P
><P
>&#13;     Se for dao o parâmetro <CODE
CLASS="parameter"
>dbname</CODE
>, irá especificar o banco de dados padrão a ser
     usado ao se executar consultas. 
    </P
><P
>&#13;     Os parâmetros <CODE
CLASS="parameter"
>port</CODE
> e <CODE
CLASS="parameter"
>socket</CODE
> são usados em 
     conjunto com o parâmetro <CODE
CLASS="parameter"
>host</CODE
> para maior controle de como conectar
     com o servidor de banc de dados. O parâmetro <CODE
CLASS="parameter"
>port</CODE
> especifica o número da porta
     a ser usada ao tentar conectar com o servidor MySQL, enquanto o parâmetro <CODE
CLASS="parameter"
>socket</CODE
>
     especifica um socket ou named pipe que deve ser usado. 
    </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
      especificar o parâmetro <CODE
CLASS="parameter"
>socket</CODE
> não irá determinar explicitamente o tipo de
      conexão a ser usada ao conectar com o servidor MySQL. Como a conexão é feita com o banco de dados
      MySQL é determinada pelo parâmetro <CODE
CLASS="parameter"
>host</CODE
>.
     </P
></BLOCKQUOTE
></DIV
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN133340"
></A
><H2
>Valores de retorno</H2
><P
>&#13;     Retorna um objeto que representa a conexão com o servidor MySQL ou
     <TT
CLASS="constant"
><B
>FALSE</B
></TT
> se a conexão falhar.
    </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN133344"
></A
><H2
>Exemplo</H2
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN133346"
></A
><P
><B
>Exemplo 1. Estilo orientado a objeto</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$mysqli </font><font color="#007700">= new </font><font color="#0000BB">mysqli</font><font color="#007700">(</font><font color="#DD0000">"localhost"</font><font color="#007700">, </font><font color="#DD0000">"my_user"</font><font color="#007700">, </font><font color="#DD0000">"my_password"</font><font color="#007700">, </font><font color="#DD0000">"world"</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* check connection */ <br /></font><font color="#007700">if (</font><font color="#0000BB">mysqli_connect_errno</font><font color="#007700">()) {<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">printf</font><font color="#007700">(</font><font color="#DD0000">"Connect failed: %s\n"</font><font color="#007700">, </font><font color="#0000BB">mysqli_connect_error</font><font color="#007700">());<br />&nbsp;&nbsp;&nbsp;&nbsp;exit();<br />}<br /><br /></font><font color="#0000BB">printf</font><font color="#007700">(</font><font color="#DD0000">"Host information: %s\n"</font><font color="#007700">, </font><font color="#0000BB">$mysqli</font><font color="#007700">-&gt;</font><font color="#0000BB">host_info</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* close connection */<br /></font><font color="#0000BB">$mysqli</font><font color="#007700">-&gt;</font><font color="#0000BB">close</font><font color="#007700">();<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN133349"
></A
><P
><B
>Exemplo 2. Estilo de procedimento</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$link </font><font color="#007700">= </font><font color="#0000BB">mysqli_connect</font><font color="#007700">(</font><font color="#DD0000">"localhost"</font><font color="#007700">, </font><font color="#DD0000">"my_user"</font><font color="#007700">, </font><font color="#DD0000">"my_password"</font><font color="#007700">, </font><font color="#DD0000">"world"</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* check connection */ <br /></font><font color="#007700">if (!</font><font color="#0000BB">$link</font><font color="#007700">) {<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">printf</font><font color="#007700">(</font><font color="#DD0000">"Connect failed: %s\n"</font><font color="#007700">, </font><font color="#0000BB">mysqli_connect_error</font><font color="#007700">());<br />&nbsp;&nbsp;&nbsp;&nbsp;exit();<br />}<br /><br /></font><font color="#0000BB">printf</font><font color="#007700">(</font><font color="#DD0000">"Host information: %s\n"</font><font color="#007700">, </font><font color="#0000BB">mysqli_get_host_info</font><font color="#007700">(</font><font color="#0000BB">$link</font><font color="#007700">));<br /><br /></font><font color="#FF8000">/* close connection */<br /></font><font color="#0000BB">mysqli_close</font><font color="#007700">(</font><font color="#0000BB">$link</font><font color="#007700">);<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
>&#13;     Os exemplos acimas devem produzir a seguinte saída:
    </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="screen"
>Host information: Localhost via UNIX socket</PRE
></TD
></TR
></TABLE
></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.mysqli-connect-error.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.mysqli-data-seek.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>mysqli_connect_error</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.mysqli.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>mysqli_data_seek</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>