mysqli_connect

(PHP 5)

mysqli_connect

(no version information, might be only in CVS)

mysqli() -- Ouvre une connexion à un serveur MySQL

Description

Style procédural

mysqli mysqli_connect ( [string host [, string username [, string passwd [, string dbname [, int port [, string socket]]]]]] )

Style orienté objet (méthode)

class mysqli {

__construct ( [string host [, 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 c'est 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 étudiant que les enregistrements où les utilisateurs n'ont pas de mot de passe. Cela permet à un utilisateur de jouir de plusieurs permissions (selon que l'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.

Valeurs de retour

Retourne un objet qui représente la connexion au serveur MySQL ou FALSE si la connexion échoue.

Exemples

Exemple 1. Style orienté objet

<?php
$mysqli
= new mysqli("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("Information sur le serveur : %s\n", $mysqli->host_info);

/* Fermeture de la connexion */
$mysqli->close();
?>

Exemple 2. Style procédural

<?php
$link
= mysqli_connect("localhost", "my_user", "my_password", "world");

/* Vérification de la connexion */
if (!$link) {
    
printf("Echec de la connexion : %s\n", mysqli_connect_error());
    exit();
}

printf("Information sur le serveur : %s\n", mysqli_get_host_info($link));

/* Fermeture de la connexion */
mysqli_close($link);
?>

L'exemple ci-dessus va afficher :

Information sur le serveur : Localhost via UNIX socket

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:01:52