<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >mysql_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 do MySQL" HREF="ref.mysql.html"><LINK REL="PREVIOUS" TITLE="mysql_close" HREF="function.mysql-close.html"><LINK REL="NEXT" TITLE="mysql_create_db" HREF="function.mysql-create-db.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.mysql-close.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.mysql-create-db.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.mysql-connect" ></A >mysql_connect</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN129419" ></A ><P > (PHP 3, PHP 4, PHP 5)</P >mysql_connect -- Abre uma conexão com um servidor MySQL</DIV ><DIV CLASS="refsect1" ><A NAME="AEN129422" ></A ><H2 >Descrição</H2 >resource <B CLASS="methodname" >mysql_connect</B > ( [string server [, string username [, string password [, bool new_link [, int client_flags]]]]] )<BR ></BR ><P > Abre ou reutiliza uma conexão com um servidor MySQL. </P ></DIV ><DIV CLASS="refsect1" ><A NAME="AEN129443" ></A ><H2 >Parâmetros</H2 ><P > <P ></P ><DIV CLASS="variablelist" ><DL ><DT ><CODE CLASS="parameter" >server</CODE ></DT ><DD ><P > O servidor MySQL. Também pode incluir um número de porta, exemplo "servidor:porta" ou um caminho para um socket local, exemplo ":/caminho/para/socket" para o servidor local(localhost). </P ><P > Se a diretiva do PHP <A HREF="ref.mysql.html#ini.mysql.default-host" > mysql.default_host</A > não estiver definida(padrão), então o valor padrão é 'localhost:3306' </P ></DD ><DT ><CODE CLASS="parameter" >username</CODE ></DT ><DD ><P > O nome de usuário. O valor padrão é o nome do usuário que é o proprietário do processo do servidor. </P ></DD ><DT ><CODE CLASS="parameter" >password</CODE ></DT ><DD ><P > A senha. O valor padrão é uma senha vazia. </P ></DD ><DT ><CODE CLASS="parameter" >new_link</CODE ></DT ><DD ><P > Se uma segunda chamada é feita a <B CLASS="function" >mysql_connect()</B > com os mesmos argumentos, não é estabelecida uma nova conexão, mas ao invés, o identificador da conexão que já esta aberta é retornado. O parâmetro <CODE CLASS="parameter" >new_link</CODE > modifica este funcionamento e faz <B CLASS="function" >mysql_connect()</B > sempre abrir uma nova conexão, mesmo que <B CLASS="function" >mysql_connect()</B > seja chamado antes com os mesmos parâmetros. </P ></DD ><DT ><CODE CLASS="parameter" >client_flags</CODE ></DT ><DD ><P > O parâmetro <CODE CLASS="parameter" >client_flags</CODE > pode ser uma combinação das seguintes constantes: <TT CLASS="constant" ><B >MYSQL_CLIENT_SSL</B ></TT >, <TT CLASS="constant" ><B >MYSQL_CLIENT_COMPRESS</B ></TT >, <TT CLASS="constant" ><B >MYSQL_CLIENT_IGNORE_SPACE</B ></TT > ou <TT CLASS="constant" ><B >MYSQL_CLIENT_INTERACTIVE</B ></TT >. Leia a seção sobre <A HREF="ref.mysql.html#mysql.client-flags" >Tabela 2</A > para maiores informações. </P ></DD ></DL ></DIV > </P ></DIV ><DIV CLASS="refsect1" ><A NAME="AEN129484" ></A ><H2 >Valores de retornado</H2 ><P > Retorna um identificador de conexão MySQL em caso de sucesso, ou <TT CLASS="constant" ><B >FALSE</B ></TT > em caso de falha. </P ></DIV ><DIV CLASS="refsect1" ><A NAME="AEN129488" ></A ><H2 >Histórico</H2 ><P > <DIV CLASS="informaltable" ><P ></P ><A NAME="AEN129491" ></A ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><THEAD ><TR ><TH >Versão</TH ><TH >Descrição</TH ></TR ></THEAD ><TBODY ><TR ><TD >4.3.0</TD ><TD > Adicionado o parâmetro <CODE CLASS="parameter" >client_flags</CODE >. </TD ></TR ><TR ><TD >4.2.0</TD ><TD > Adicionado o parâmetro <CODE CLASS="parameter" >new_link</CODE >. </TD ></TR ><TR ><TD >3.0.10</TD ><TD > Adicionado o suporte para ":/caminho/para/socket" com <CODE CLASS="parameter" >server</CODE >. </TD ></TR ><TR ><TD >3.0.0</TD ><TD > Adicionado o suporte para ":porta" com <CODE CLASS="parameter" >server</CODE >. </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV > </P ></DIV ><DIV CLASS="refsect1" ><A NAME="AEN129514" ></A ><H2 >Exemplos</H2 ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN129517" ></A ><P ><B >Exemplo 1. Exemplo <B CLASS="function" >mysql_connect()</B ></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">mysql_connect</font><font color="#007700">(</font><font color="#DD0000">'localhost'</font><font color="#007700">, </font><font color="#DD0000">'mysql_user'</font><font color="#007700">, </font><font color="#DD0000">'mysql_password'</font><font color="#007700">);<br />if (!</font><font color="#0000BB">$link</font><font color="#007700">) {<br /> die(</font><font color="#DD0000">'Não foi possível conectar: ' </font><font color="#007700">. </font><font color="#0000BB">mysql_error</font><font color="#007700">());<br />}<br />echo </font><font color="#DD0000">'Conexão bem sucedida'</font><font color="#007700">;<br /></font><font color="#0000BB">mysql_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 > </P ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN129522" ></A ><P ><B >Exemplo 2. Exemplo <B CLASS="function" >mysql_connect()</B > usando a a sintaxe <TT CLASS="literal" >servidor:porta</TT ></B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /></font><font color="#FF8000">// nós conectamos com example.com na porta 3307<br /></font><font color="#0000BB">$link </font><font color="#007700">= </font><font color="#0000BB">mysql_connect</font><font color="#007700">(</font><font color="#DD0000">'example.com:3307'</font><font color="#007700">, </font><font color="#DD0000">'mysql_user'</font><font color="#007700">, </font><font color="#DD0000">'mysql_password'</font><font color="#007700">);<br />if (!</font><font color="#0000BB">$link</font><font color="#007700">) {<br /> die(</font><font color="#DD0000">'Não foi possível conectar: ' </font><font color="#007700">. </font><font color="#0000BB">mysql_error</font><font color="#007700">());<br />}<br />echo </font><font color="#DD0000">'Conexão bem sucedida'</font><font color="#007700">;<br /></font><font color="#0000BB">mysql_close</font><font color="#007700">(</font><font color="#0000BB">$link</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// nós conectamos com localhost na porta 3307<br /></font><font color="#0000BB">$link </font><font color="#007700">= </font><font color="#0000BB">mysql_connect</font><font color="#007700">(</font><font color="#DD0000">'127.0.0.1:3307'</font><font color="#007700">, </font><font color="#DD0000">'mysql_user'</font><font color="#007700">, </font><font color="#DD0000">'mysql_password'</font><font color="#007700">);<br />if (!</font><font color="#0000BB">$link</font><font color="#007700">) {<br /> die(</font><font color="#DD0000">'Não foi possível conectar: ' </font><font color="#007700">. </font><font color="#0000BB">mysql_error</font><font color="#007700">());<br />}<br />echo </font><font color="#DD0000">'Conexão bem sucedida'</font><font color="#007700">;<br /></font><font color="#0000BB">mysql_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 > </P ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN129528" ></A ><P ><B >Exemplo 3. Exemplo <B CLASS="function" >mysql_connect()</B > usando a sintaxe ":/caminho/para/socket"</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /></font><font color="#FF8000">// nós conectamos com localhost e socket exemplo /tmp/mysql.sock<br /><br />//variação 1: omitindo localhost<br /></font><font color="#0000BB">$link </font><font color="#007700">= </font><font color="#0000BB">mysql_connect</font><font color="#007700">(</font><font color="#DD0000">'/tmp/mysql'</font><font color="#007700">, </font><font color="#DD0000">'mysql_user'</font><font color="#007700">, </font><font color="#DD0000">'mysql_password'</font><font color="#007700">);<br />if (!</font><font color="#0000BB">$link</font><font color="#007700">) {<br /> die(</font><font color="#DD0000">'Não foi possível conectar: ' </font><font color="#007700">. </font><font color="#0000BB">mysql_error</font><font color="#007700">());<br />}<br />echo </font><font color="#DD0000">'Conexão bem sucedida'</font><font color="#007700">;<br /></font><font color="#0000BB">mysql_close</font><font color="#007700">(</font><font color="#0000BB">$link</font><font color="#007700">);<br /><br /><br /></font><font color="#FF8000">// variant 2: with localhost<br /></font><font color="#0000BB">$link </font><font color="#007700">= </font><font color="#0000BB">mysql_connect</font><font color="#007700">(</font><font color="#DD0000">'localhost:/tmp/mysql.sock'</font><font color="#007700">, </font><font color="#DD0000">'mysql_user'</font><font color="#007700">, </font><font color="#DD0000">'mysql_password'</font><font color="#007700">);<br />if (!</font><font color="#0000BB">$link</font><font color="#007700">) {<br /> die(</font><font color="#DD0000">'Não foi possível conectar: ' </font><font color="#007700">. </font><font color="#0000BB">mysql_error</font><font color="#007700">());<br />}<br />echo </font><font color="#DD0000">'Conexão bem sucedida'</font><font color="#007700">;<br /></font><font color="#0000BB">mysql_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 > </P ></DIV ><DIV CLASS="refsect1" ><A NAME="AEN129532" ></A ><H2 >Notas</H2 ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Em qualquer lugar que você especificar "localhost" ou "localhost:porta" como servidor, a biblioteca de cliente do MySQL irá sobrescrever isso e tentar conectar com um socket local (named pipe no Windows). Se você quiser usar TCP/IP, use "127.0.0.1" ao invés de "localhost". Se a biblioteca de cliente do MySQL tentar conectar com o socket local errado, você deverá definir o caminho correto como <A HREF="ref.mysql.html#ini.mysql.default-host" ><I CLASS="term" > <CODE CLASS="parameter" >mysql.default_host</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A > </I ></A > na sua configuração do PHP e deixar o campo servidor em branco. </P ></BLOCKQUOTE ></DIV ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > A conexão com o servidor será fechada assim que a execução do script terminar, a menos que tenha sido fechada anteriormente usando-se explicitamente <A HREF="function.mysql-close.html" ><B CLASS="function" >mysql_close()</B ></A >. </P ></BLOCKQUOTE ></DIV ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Você pode suprimir a mensagem de erro em caso de falha adicionando ante do nome da função <A HREF="language.operators.errorcontrol.html" >@</A >. </P ></BLOCKQUOTE ></DIV ></DIV ><DIV CLASS="refsect1" ><A NAME="AEN129543" ></A ><H2 >Veja também</H2 ><P > <P ></P ><TABLE BORDER="0" ><TBODY ><TR ><TD ><A HREF="function.mysql-pconnect.html" ><B CLASS="function" >mysql_pconnect()</B ></A ></TD ></TR ><TR ><TD ><A HREF="function.mysql-close.html" ><B CLASS="function" >mysql_close()</B ></A ></TD ></TR ></TBODY ></TABLE ><P ></P > </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.mysql-close.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.mysql-create-db.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >mysql_close</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.mysql.html" ACCESSKEY="U" >Acima</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >mysql_create_db</TD ></TR ></TABLE ></DIV ></BODY ></HTML >