Manual do PHP
Anterior |  | Próxima

# mysql_connect

(PHP 3, PHP 4 )

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, exemplo. ":/path/to/socket" para o servidor local (localhost).

> 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") or die("Não pude conectar: " . mysql_error()); print ("Conectado"); mysql_close($link); ?>`

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

Anterior | Principal | Próxima
mysql_close | Acima | mysql_create_db