mysql_connect

(PHP 4, PHP 5)

mysql_connect — Ouvre une connexion � un serveur MySQL

Description

resource mysql_connect ([ string $server= ini_get("mysql.default_host") [, string $username= ini_get("mysql.default_user") [, string $password= ini_get("mysql.default_password") [, bool $new_link= false [, int $client_flags= 0 ]]]]] )

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". En safe mode SQL, ce param�tre est ignor� et la valeur "localhost:3306" est toujours utilis�e.

username

Le nom d'utilisateur. La valeur par d�faut est d�finie par l'option mysql.default_user. En safe mode SQL, ce param�tre est ignor� et le nom de l'utilisateur propri�taire du processus serveur est utilis�.

password

Le mot de passe. La valeur par d�faut est d�finie par l'option mysql.default_password. En safe mode SQL, ce param�tre est ignor� et un mot de passe vide est utilis�.

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. En safe mode SQL, ce param�tre est ignor�.

client_flags

Le param�tre client_flags peut �tre une combinaison des constantes suivantes : 128 (active le gestionnaire LOAD DATA LOCAL), MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE ou MYSQL_CLIENT_INTERACTIVE. Lisez la section � propos de Constantes pr�-d�finies pour plus d'informations. En safe mode SQL, ce param�tre est ignor�.

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 .

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 � Configuration � l'ex�cution 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 @.

Note: L'erreur "Can't create TCP/IP socket (10106)" signifie habituellement que la directive de configuration variables_order ne contient pas le caract�re E. Sous Windows, si la variable d'environnement n'est pas copi�e, la variable d'environnement SYSTEMROOT ne sera pas disponible et PHP aura des probl�mes pour charger Winsock.

Voir aussi

Fonctions MySQL
PHP Manual