Manuel PHP
Précédent |  | Suivant

# 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

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

Précédent | Sommaire | Suivant
mysqli_connect_error | Niveau supérieur | mysqli_data_seek