mysqli_real_connect

Manuel PHP
Précédent		Suivant

Description

Style procédural

bool mysqli_real_connect ( mysqli link [, string hostname [, string username [, string passwd [, string dbname [, int port [, string socket [, int flags]]]]]]] )

Style orienté objet (méthode)

class mysqli {

bool real_connect ( [string hostname [, string username [, string passwd [, string dbname [, int port [, string socket [, int flags]]]]]]] )

}

mysqli_real_connect() tente d'établir une connexion avec un serveur MySQL d'un hôte.

Cette fonction diffère de mysqli_connect() en ces points :

mysqli_real_connect() a besoin d'un objet valide issu de la fonction mysqli_init()
Avec la fonction mysqli_options(), vous pouvez définir différentes options pour la connexion.

Avec les paramètres flags, vous pouvez définir différents options de la connexion :

Tableau 1. Flags supportés

Nom	Description
`MYSQLI_CLIENT_COMPRESS`	Utilise un protocole de compression
`MYSQLI_CLIENT_FOUND_ROWS`	Retourne le nombre de lignes sélectionnées, et non pas le nombre de lignes affectées
`MYSQLI_CLIENT_IGNORE_SPACE`	Accepte les espaces après les noms de fonctions. Fait que tous les noms de fonctions sont des mots réservés.
`MYSQLI_CLIENT_INTERACTIVE`	Permet `interactive_timeout` secondes (au lieu de `wait_timeout` secondes) d'inactivité avant de fermer la connexion
`MYSQLI_CLIENT_SSL`	Utilise SSL (chiffrage)

Note : Pour des raisons de sécurité, le flag MULTI_STATEMENT n'est pas supporté en PHP. Si vous voulez exécuter plusieurs requêtes, utilisez la fonction mysqli_multi_query().

Exemples

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("Echec 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("Echec 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

Précédent	Sommaire	Suivant
mysqli_query	Niveau supérieur	mysqli_real_escape_string

mysqli_real_connect

Description

Valeurs de retour

Exemples

Voir aussi