(PHP 5)
mysqli_real_connect(no version information, might be only in CVS)
mysqli->real_connect() -- Ouvre une connexion à un serveur MySQLStyle procédural
bool mysqli_real_connect ( mysqli link [, string host [, string username [, string passwd [, string dbname [, int port [, string socket [, int flags]]]]]]] )Style orienté objet (méthode)
class mysqli {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
Il y a un paramètre flags
link
Style procédural uniquement : Un identifiant de lien retourné par la fonction mysqli_connect() ou par la fonction mysqli_init()
host
Peut être soit un nom d'hôte, soit une adresse IP. Si vous passez la valeur NULL ou la chaîne de caractères "localhost", l'hôte local sera utilisé. Lorsque c'est possible, un tunnel sera utilisé au lieu du protocole TCP/IP.
username
Le nom d'utilisateur MySQL.
passwd
Si fourni ou si vaut NULL, le serveur MySQL tentera d'identifier l'utilisateur par rapport aux utilisateurs présents dans la base MySQL qui n'ont pas de mot de passe associé. Ceci permet à un utilisateur d'être utilisé avec des permissions différentes (suivant si un mot de passe est fourni ou non).
dbname
Si fourni, spécifie la base de données par défaut à utiliser lors de l'exécution de requêtes.
port
Spécifie le numéro du port à utiliser pour la connexion au serveur MySQL.
socket
Spécifie le socket ou le tunnel nommé à utiliser..
Note : Le fait de spécifier le paramètre
socket
ne détermine pas de façon explicite le type de connexion à utiliser lors de la connexion au serveur MySQL. La façon dont la connexion est réellement effectuée dépend du paramètrehost
.
flags
Avec le paramètre 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().
Exemple 2. Style procédural
|
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 |