mysql_connect

(PHP 3, PHP 4 , PHP 5)

mysql_connect -- Abre uma conexão com o servidor MySQL

Descrição

resource mysql_connect ( [string server [, string username [, string password [, bool new_link [, int client_flags]]]]] )

Retorna um identificador de link (link_identifier) com o MySQL se der certo, ou FALSE se falhar.

mysql_connect() estabelece uma conexão com o servidor MySQL. Os seguintes padrões são assumidos para os argumentos opcionais que estiverem faltando: server = 'localhost:3306', username = nome do usuário dono do processo do servidor, password = senha vazia.

O parâmetro server pode também incluir um número de porta. Exemplo "hostname:port" ou um caminho para um socket local, exemplo ":/path/to/socket" para o servidor local

Nota: Em qualquer lugar que você especificar "localhost" ou "localhost:port" como servidor, a biblioteca de cliente MySQL irá sobrepor isto e tentar conectar com um socket local (named pipe no Windows). Se você quizer usar TCP/IP, use "127.0.0.1" ao invés de "localhost". Se biblioteca de cliente MySQL tentar conectar ao socket local errado, você deverá estabelecer o caminho correto em mysql.default_host na sua configuração do PHP e deixar o campo do servidor em branco.

Suporte para ":port" foi adicionado no PHP 3.0B4.

Suporte para ":/path/to/socket" foi adicionado no PHP 3.0.10.

Você pode suprimir a mensagem de erro em caso de falha colocando um @ antes do nome da função.

Se uma segunda chamada é feita para mysql_connect() com os mesmos argumentos, um novo link não será estabelecido, mas ao invés disto o identificador da conexão já aberta será retornado. O parâmetro new_link modifica esta opção e faz com que a função mysql_connect() sempre abra um novo link, mesmo que mysql_connect() seja chamada com os mesmos parâmetros. O parâmetro client_flags pode ser uma combinação das constantes MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE ou MYSQL_CLIENT_INTERACTIVE.

Nota: O parâmetro new_link tornou-se disponível no PHP 4.2.0

O parâmetro client_flags tornou-se disponível no PHP 4.3.0

O link com o servidor será fechado tão logo a execução do script termine, se não tiver sido fechado anteriormente por chamar explicita à mysql_close().

Exemplo 1. Exemplo de conexão MySQL

<?php
   $link
= mysql_connect('localhost', 'mysql_user', 'mysql_password');
   if (!
$link) {
       die(
'Não foi possível conectar: ' . mysql_error());
   }
   echo
'Conexão bem sucedida';
   
mysql_close($link);
?>

Veja também mysql_pconnect() e mysql_close().