mysql_connect
(PHP 4, PHP 5)
mysql_connect — Ouvre une connexion � un serveur MySQL
Description
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
- mysql_pconnect() - Ouvre une connexion persistante � un serveur MySQL
- mysql_close() - Ferme la connexion MySQL