Manuel PHP
Précédent |  | Suivant

# mysql_connect

(PHP 3, PHP 4, PHP 5)

mysql_connect -- Ouvre une connexion à un serveur MySQL

## Description

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

Ouvre ou réutilise une connexion à un serveur MySQL.

## Liste de paramètres

server

  Le serveur MySQL. Il peut aussi inclure le numéro de port. C'est-à-dire "hostname:port" ou le chemin vers le socket local, c'est-à-dire ":/path/to/socket" pour localhost.

  Si la directive PHP mysql.default_host n'est pas définie (défaut), alors la valeur par défaut est 'localhost:3306'

username

  Le nom d'utilisateur. La valeur par défaut est le nom de l'utilisateur qui détient le processus du serveur.

password

  Le mot de passe. La valeur par défaut est une mot de passe vide.

new_link

  Si un deuxième appel est fait à mysql_connect() avec les mêmes arguments, aucune nouvelle connexion ne sera établie, mais plutôt, l'identifiant de la connexion de la connexion déjà ouverte sera retourné. Le paramètre new_link modifie ce comportement et permet à mysql_connect() de toujours ouvrir une nouvelle connexion, même si mysql_connect() a été appelée avant avec les mêmes paramètres.

client_flags

  Le paramètre client_flags peut être une combinaison des constantes suivantes : `MYSQL_CLIENT_SSL`, `MYSQL_CLIENT_COMPRESS`, `MYSQL_CLIENT_IGNORE_SPACE` ou `MYSQL_CLIENT_INTERACTIVE`. Lisez la section à propos de Tableau 2 pour plus d'informations.

## Valeurs de retour

Retourne l'identifiant de connexion MySQL en cas de succès ou `FALSE` en cas d'échec.

## Historique

Version | Description
--- | ---
4.3.0 | Ajout du paramètre client_flags.
4.2.0 | Ajout du paramètre new_link.
3.0.10 | Ajout du support pour ":/path/to/socket" avec server.
3.0.0 | Ajout du support pour ":port" avec server.

## Exemples

Exemple 1. Exemple avec mysql_connect()

`<?php $link = mysql_connect("localhost", "mysql_user", "mysql_password") or die("Impossible de se connecter : " . mysql_error()); echo 'Connexion réussie'; mysql_close($link); ?>`

Exemple 2. Exemple avec mysql_connect() en utilisant la syntaxe hostname:port

`<?php
// on se connecte à example.com et au port 3307
$link = mysql_connect('example.com:3307', 'mysql_user', 'mysql_password');
if (!$link) {
die('Connexion impossible : ' . mysql_error());
}
echo 'Connecté correctement';
mysql_close($link);
// on se connect à localhost au port 3307
$link = mysql_connect('127.0.0.1:3307', 'mysql_user', 'mysql_password');
if (!$link) {
die('Connexion impossible : ' . mysql_error());
}
echo 'Connecté correctement';
mysql_close($link);
?>`

Exemple 3. Exemple avec mysql_connect() en utilisant la syntaxe ":/path/to/socket"

`<?php
// on se connect à localhost et à l'interface de connexion, par exemple /tmp/mysql.sock
//variante 1 : oublie de localhost
$link = mysql_connect('/tmp/mysql', 'mysql_user', 'mysql_password');
if (!$link) {
die('Connexion impossible : ' . mysql_error());
}
echo 'Connecté correctement';
mysql_close($link);
// variante 2 : avec localhost
$link = mysql_connect('localhost:/tmp/mysql.sock', 'mysql_user', 'mysql_password');
if (!$link) {
die('Connexion impossible : ' . mysql_error());
}
echo 'Connecté correctement';
mysql_close($link);
?>`

## Notes

> Note : Toutes les fois que vous spécifiez "localhost" ou "localhost:port" en tant que serveur, le bibliothèque client MySQL surchargera cela et essaiera de se connecter à un socket local (nommé pipe sous Windows). Si vous souhaitez utiliser TCP/IP, utilisez "127.0.0.1" au lieu de "localhost". Si la bibliothèque client MySQL essaie de se connecter au mauvais socket local, vous devriez spécifier le chemin d'accès correct à mysql.default_host string dans votre configurations PHP et laisser le champ du serveur vide.

> Note : La connexion au serveur sera fermée aussitôt que l'exécution du script se termine, à moins qu'elle soit fermée avant en appelant explicitement mysql_close().

> Note : Vous pouvez supprimer les messages d'erreur en cas d'échec en faisant précéder le nom de la fonction par @.

## Voir aussi

mysql_pconnect()
mysql_close()

Précédent | Sommaire | Suivant
mysql_close | Niveau supérieur | mysql_create_db