mysql_close
mysql_create_db
Funções da MySQL
PHP Manual

# mysql_connect

(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 Constante do cliente 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

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 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() - Abre uma conexão persistente com um servidor MySQL
- mysql_close() - Fecha a conexão MySQL

mysql_close
mysql_create_db
Funções da MySQL
PHP Manual