Manuel PHP
Précédent |  | Suivant

# mysqli_real_connect

(PHP 5)

mysqli_real_connect

(no version information, might be only in CVS)

mysqli->real_connect -- Ouvre une connexion à un serveur MySQL

## 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().

## Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès, `FALSE` en cas d'échec.

## Voir aussi

mysqli_connect(), mysqli_init(), mysqli_options(), mysqli_ssl_set() et mysqli_close().

## 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