Manuel PHP
Précédent |  | Suivant

# mysql_connect

(PHP 3, PHP 4 , PHP 5)

mysql_connect -- Ouvre une connexion à un serveur MySQL

## Description

resource mysql_connect ( [string server [, string username [, string password [, bool new_link [, int client_flags]]]]])

mysql_connect() retourne une ressource de connexion au serveur MySQL en cas de succès, et sinon `FALSE`.

mysql_connect() établit une connexion à un serveur MySQL. Tous les arguments sont optionnels, et s'ils manquent, les valeurs par défaut sont utilisées : `server` vaut `'localhost:3306'`, `username` vaut le nom de l'utilisateur propriétaire du processus courant, et `password` est le mot de passe vide.

Le nom d'hôte `server` peut aussi inclure un numéro de port, sous la forme : `"hostname:port"` ou un chemin jusqu'à une socket sous la forme `":/path/to/socket` pour l'hôte `localhost`.

> Note : Le support des `:port` a été ajouté à partir de la version 3.0B4.

> Le support de `:/path/to/socket` a été ajouté à partir de la version 3.0.10.

> Vous pouvez supprimer le message d'erreur de connexion en ajoutant une arobase @ au nom de la fonction.

Si un second appel à mysql_connect() est fait avec les mêmes arguments, `PHP` ne va pas ouvrir une nouvelle connexion, mais va retourner l'identifiant de la connexion déjà ouverte. Le paramètre `new_link` modifie ce comportement et permet que mysql_connect() ouvre une nouvelle connexion même si mysql_connect() a été appelée auparavant avec les mêmes paramètres. Le paramètre `client_flags` peut être une combinaison des constantes suivantes : `MYSQL_CLIENT_SSL`, `MYSQL_CLIENT_COMPRESS`, `MYSQL_CLIENT_IGNORE_SPACE` et `MYSQL_CLIENT_INTERACTIVE`.

> Note : La paramètre `new_link` a été ajouté en `PHP` 4.2.0.

> La paramètre `client_flags` a été ajouté en `PHP` 4.3.0

Le lien sera fermé automatiquement dès que l'exécution du script sera terminée, à moins d'être fermé explicitement avec mysql_close().

Exemple 1. Exemple avec mysql_connect()

`<?php $link = mysql_connect("localhost", "mysql_user", "mysql_password") or die("Impossible de se connecter : " . mysql_error()); print ("Connexion réussie."); mysql_close($link); ?>`

Voir aussi mysql_pconnect() et mysql_close().

Précédent | Sommaire | Suivant
mysql_close | Niveau supérieur | mysql_create_db