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