mysqli_connect

(PHP 5 CVS only)

mysqli_connect -- Ouvre une connexion à un serveur MySQL

Description

resource mysqli_connect ( [string hostname [, string username [, string passwd [, string dbname [, int port [, string socket]]]]]])

La fonction mysqli_connect() essaie d'ouvrir une connexion au serveur MySQL de l'hôte host qui peut être un nom d'hôte ou une adresse IP. Si vous passez la valeur NULL ou la chaîne "localhost" à ce paramètre, l'hôte local est sous-entendu. Lorsque possible, les sockets seront utilisées au lieu du protocole TCP/IP. mysqli_connect() retourne une ressource de connexion au serveur MySQL en cas de succès, et sinon FALSE.

Les paramètres username et password spécifient l'utilisateur et le mot de passe avec lesquels on se connecte au serveur MySQL. Si le mot de passe n'est pas indiqué (la valeur NULL est passée), le serveur MySQL essaiera d'identifier l'utilisateur en n'étudiant que les enregistrements où les utilisateurs n'ont pas de mot de passe. Cela permet à un utilisateur de jouir de plusieurs permissions (selon qu'on fournit le mot de passe ou non).

Le paramètre dbname, si fourni, spécifiera la base de données par défaut à utiliser lors de l'exécution de requêtes.

Les paramètres port et socket sont utilisés en conjonction avec le paramètre hostname pour mieux contrôler la manière dont la connexion au serveur se fait. Le paramètre port spécifie le numéro de port à utiliser, tandis que le paramètre socket spécifie la socket ou le tunnel nommé qui doit être utilisé.

Note : Spécifier le paramètre socket ne déterminera pas explicitement le type de connexion qui sera utilisé lors de la connexion au serveur MySQL. Cela est déterminé par le paramètre host.

Exemple 1. Utilisation de la fonction mysqli_connect()

<?php
                                                                                  
/* Ouvre une connexion en tant que foo@localhost et s&eacute;lectionne
   bar comme base de donn&eacute;es par d&eacute;faut */
$link = mysqli_connect("localhost", "foo", "password", "bar");

?>

Voir aussi mysqli_close() et mysqli_real_connect().