mysql_connect
(PHP 4, PHP 5, PECL mysql:1.0)
mysql_connect — Abre uma conexão com um servidor MySQL
Descrição
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 MySQL para maiores informações.
Valor Retornado
Retorna um identificador de conexão MySQL em caso de sucesso, ou FALSE em caso de falha.
Histórico
| 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 . |
Exemplos
Example#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);
?>
Example#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);
?>
Example#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 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 @.