(PHP 5)
mysqli::real_connect -- mysqli_real_connect — Ouvre une connexion à un serveur MySQL
Style orienté objet :
Style procédural :
Établit une connexion avec un serveur MySQL.
Cette fonction diffère de mysqli_connect() :
mysqli_real_connect() a besoin d'un objet créé correctement avec mysqli_init().
Avec la fonction mysqli_options(), vous pouvez configurer différentes options de connexion.
Il y a un paramètre supplémentaire flags .
Style procédural uniquement : Un identifiant de lien retourné par la fonction mysqli_connect() ou par la fonction mysqli_init()
Peut-être un nom d'hôte ou une adresse IP. En utilisant la valeur NULL ou la chaîne "localhost", l'hôte local est utilisé. Lorsque c'est possible, les pipes seront utilisés à la place de la pile TCP/IP.
Le nom d'utilisateur MySQL.
Si non fourni ou NULL, le serveur MySQL tentera de réaliser l'identification avec les utilisateurs sans mot de passe. Cela permet à un nom d'utilisateur d'être utilisé avec différentes droits, suivant que le mot de passe est fourni ou pas.
Si fourni, ce paramètre indique le nom de la base de données de travail par défaut.
Spécifie le numéro de port à utiliser pour se connecter au serveur MySQL.
Spécifie la socket ou le pipe nommé qui doit être utilisé pour établir la connexion.
Note: Spécifier explicitement le paramètre socket ne détermine pas le type de méthode utilisée lors de la connexion à MySQL. La méthode est déterminée par le paramètre host .
Avec le paramètre flags , vous pouvez configurer différentes directives de connexion :
| Nom | Description |
|---|---|
| MYSQLI_CLIENT_COMPRESS | Utilise le protocole compressé |
| MYSQLI_CLIENT_FOUND_ROWS | Retourne le nombre de ligne trouvées, pas le nombre de lignes affectées. |
| MYSQLI_CLIENT_IGNORE_SPACE | Autorise les espaces entre les noms de fonctions et les arguments. Cela force les noms de fonctions à être des mots réservés. |
| MYSQLI_CLIENT_INTERACTIVE | Autorise interactive_timeout secondes (au lieu de wait_timeout secondes) d'inactivité avant de fermer la connexion. |
| MYSQLI_CLIENT_SSL | Utilise le chiffrement SSL |
Note: Pour des raisons de sécurité, l'option MULTI_STATEMENT n'est pas supportée en PHP. Si vous voulez exécuter plusieurs commandes, utilisez la fonction mysqli_multi_query().
Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.
Exemple #1 Style orienté objet
<?php
/* Création d'un objet de connexion, sans être connecté */
$mysqli = mysqli_init();
/* Définition des quelques options de connexion */
$mysqli->options(MYSQLI_INIT_COMMAND, "SET AUTOCOMMIT=0");
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5);
/* Connexion au serveur */
$mysqli->real_connect('localhost', 'my_user', 'my_password', 'world');
/* Vérification de la connexion */
if (mysqli_connect_errno()) {
printf("Échec de la connexion : %s\n", mysqli_connect_error());
exit();
}
printf ("Connecté : %s\n.", $mysqli->host_info);
$mysqli->close();
?>
Exemple #2 Style procédural
<?php
/* Création d'un objet de connexion, sans être connecté */
$link = mysqli_init();
/* Définition des quelques options de connexion */
mysqli_options($link, MYSQLI_INIT_COMMAND, "SET AUTOCOMMIT=0");
mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5);
/* Connexion au serveur */
mysqli_real_connect($link, 'localhost', 'my_user', 'my_password', 'world');
/* Vérification de la connexion */
if (mysqli_connect_errno()) {
printf("Échec de la connexion : %s\n", mysqli_connect_error());
exit();
}
printf ("Connecté : %s\n.", mysqli_get_host_info($link));
mysqli_close($link);
?>
L'exemple ci-dessus va afficher :
Connecté : Localhost via UNIX socket