mysql_connect

(PHP 3, PHP 4, PHP 5)

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

Descrição

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

Abre ou reutiliza uma conexão com um servidor MySQL.

Parâmetros

server

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).

Se a diretiva do PHP mysql.default_host não estiver definida(padrão), então o valor padrão é 'localhost:3306'

username

O nome de usuário. O valor padrão é o nome do usuário que é o proprietário do processo do servidor.

password

A senha. O valor padrão é uma senha vazia.

new_link

Se uma segunda chamada é feita a mysql_connect() 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 new_link modifica este funcionamento e faz mysql_connect() sempre abrir uma nova conexão, mesmo que mysql_connect() seja chamado antes com os mesmos parâmetros.

client_flags

O parâmetro client_flags pode ser uma combinação das seguintes constantes: MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE ou MYSQL_CLIENT_INTERACTIVE. Leia a seção sobre Tabela 2 para maiores informações.

Valores de retornado

Retorna um identificador de conexão MySQL em caso de sucesso, ou FALSE em caso de falha.

Histórico

VersãoDescrição
4.3.0 Adicionado o parâmetro client_flags.
4.2.0 Adicionado o parâmetro new_link.
3.0.10 Adicionado o suporte para ":/caminho/para/socket" com server.
3.0.0 Adicionado o suporte para ":porta" com server.

Exemplos

Exemplo 1. Exemplo mysql_connect()

<?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);
?>

Exemplo 2. Exemplo mysql_connect() usando a a sintaxe servidor:porta

<?php
// nós conectamos com example.com na porta 3307
$link = mysql_connect('example.com:3307', 'mysql_user', 'mysql_password');
if (!
$link) {
    die(
'Não foi possível conectar: ' . mysql_error());
}
echo
'Conexão bem sucedida';
mysql_close($link);

// nós conectamos com localhost na porta 3307
$link = mysql_connect('127.0.0.1:3307', 'mysql_user', 'mysql_password');
if (!
$link) {
    die(
'Não foi possível conectar: ' . mysql_error());
}
echo
'Conexão bem sucedida';
mysql_close($link);
?>

Exemplo 3. Exemplo mysql_connect() usando a sintaxe ":/caminho/para/socket"

<?php
// nós conectamos com localhost e socket exemplo /tmp/mysql.sock

//variação 1: omitindo localhost
$link = mysql_connect('/tmp/mysql', 'mysql_user', 'mysql_password');
if (!
$link) {
    die(
'Não foi possível conectar: ' . mysql_error());
}
echo
'Conexão bem sucedida';
mysql_close($link);


// variant 2: with localhost
$link = mysql_connect('localhost:/tmp/mysql.sock', 'mysql_user', 'mysql_password');
if (!
$link) {
    die(
'Não foi possível conectar: ' . mysql_error());
}
echo
'Conexão bem sucedida';
mysql_close($link);
?>

Notas

Nota: 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 mysql.default_host string na sua configuração do PHP e deixar o campo servidor em branco.

Nota: 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 mysql_close().

Nota: Você pode suprimir a mensagem de erro em caso de falha adicionando ante do nome da função @.

Veja também

mysql_pconnect()
mysql_close()