(PHP 4, PHP 5)
mysql_connect — Abre uma conexão com um servidor MySQL
$server
[, string $username
[, string $password
[, bool $new_link
[, int $client_flags
]]]]] )Abre ou reutiliza uma conexão com um servidor MySQL.
serverO 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'
usernameO nome de usuário. O valor padrão é o nome do usuário que é o proprietário do processo do servidor.
passwordA 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 Constante do cliente MySQL para maiores informações.
Retorna um identificador de conexão MySQL em caso de sucesso, ou FALSE em caso de falha.
| Versão | Descriçã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.
|
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);
?>
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 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 @.