maxdb_connect

(PECL)

maxdb_connect

(no version information, might be only in CVS)

maxdb() -- Oubre une nouvelle connexion sur un serveur MaxDB

Description

Style procédural

resource maxdb_connect ( [string host [, string username [, string passwd [, string dbname [, int port [, string socket]]]]]] )

Style orienté objet (méthode)

class maxdb {

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

}

maxdb_connect() tente d'ouvrir une connexion sur un serveur MaxDB fonctionnant sur l'hôte host qui peut être soit un nom d'hôte, soit une adresse IP. Passer la chaîne "localhost" à ce paramètre, l'hôte local sera assumé. En cas de succès, maxdb_connect() retournera une ressource représentant la connexion à la base de données, ou FALSE si une erreur survient.

Les paramètres username et password spécifient le nom de l'utilisateur ainsi que le mot de passe utilisés pour la connexion au serveur MaxDB. Si le mot de passe n'est pas fourni (la valeur NULL est passée), le serveur MaxDB tentera d'identifier l'utilisateur encore une fois en utilisant la valeur de l'option de configuration maxdb.default_pw du php.ini.

Le paramètre dbname, si fourni, spécifie la base de données par défaut à utiliser lors de l'exécution de requêtes. S'il n'est pas fourni, l'option de configuration maxdb.default_db du php.ini est utilisée.

Les paramètres port et socket sont ignorés par le serveur MaxDB.

Valeurs de retour

Retourne une ressource représentant la connexion au serveur MaxDB ou FALSE si la connexion échoue.

Exemples

Exemple 1. Style orienté objet

<?php
$maxdb
= new maxdb("localhost", "MONA", "RED", "DEMODB");

/* Vérfication de la connexion */
if (maxdb_connect_errno()) {
  
printf("Echec de la connexion : %s\n", maxdb_connect_error());
  exit();
}

printf("Informations sur l'hôte : %s\n", $maxdb->host_info);

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

Exemple 2. Style procédural

<?php
$link
= maxdb_connect("localhost", "MONA", "RED");

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

printf("Informations sur l'hôte : %s\n", maxdb_get_host_info($link));

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

L'exemple ci-dessus va afficher :

Informations sur l'hôte : localhost

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