6.24 MySQL
6 Référence des fonctions
Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes pré-définies
. Notes
. Exemples
. mysql_affected_rows
. mysql_change_user
. mysql_client_encoding
. mysql_close
->mysql_connect
. mysql_create_db
. mysql_data_seek
. mysql_db_name
. mysql_db_query
. mysql_drop_db
. mysql_errno
. mysql_error
. mysql_escape_string
. mysql_fetch_array
. mysql_fetch_assoc
. mysql_fetch_field
. mysql_fetch_lengths
. mysql_fetch_object
. mysql_fetch_row
. mysql_field_flags
. mysql_field_len
. mysql_field_name
. mysql_field_seek
. mysql_field_table
. mysql_field_type
. mysql_free_result
. mysql_get_client_info
. mysql_get_host_info
. mysql_get_proto_info
. mysql_get_server_info
. mysql_info
. mysql_insert_id
. mysql_list_dbs
. mysql_list_fields
. mysql_list_processes
. mysql_list_tables
. mysql_num_fields
. mysql_num_rows
. mysql_pconnect
. mysql_ping
. mysql_query
. mysql_real_escape_string
. mysql_result
. mysql_select_db
. mysql_stat
. mysql_tablename
. mysql_thread_id
. mysql_unbuffered_query
|
6.24.13 mysql_connect()Ouvre une connexion à un serveur MySQL[ Exemples avec mysql_connect ] PHP 3, PHP 4, PHP 5
resource
mysql_connect (
string
server
,
string
username
,
string
password
,
bool
new_link
,
int
client_flags
)
Ouvre ou réutilise une connexion à un serveur MySQL.
-
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 Constantes client MySQL
pour plus d'informations.
Retourne l'identifiant de connexion MySQL en cas de succès ou
FALSE
en
cas d'échec.
| 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
.
|
| 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 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 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);
?>
|
| 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
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 @ .
|
|