# cubrid_connect

(PECL CUBRID >= 8.3.1)

cubrid_connect — Ouvre une connexion au serveur CUBRID

### Description

cubrid_connect(
string `$host`,
int `$port`,
string `$dbname`,
string `$userid` = ?,
string `$passwd` = ?,
bool `$new_link` = `false`
): resource

La fonction cubrid_connect() est utilisée pour établir l'environnement pour une connexion au serveur en utilisant l'adresse du serveur, le numéro du port, le nom de la base de données, le nom d'utilisateur et son mot de passe. Si le nom d'utilisateur et le mot de passe ne sont pas fournis, alors une connexion "PUBLIC" sera effectuée par défaut.

### Liste de paramètres

`host`

  Nom d'hôte ou adresse IP du serveur CUBRID CAS.

`port`

  Numéro du port du serveur CUBRID CAS (BROKER_PORT est configuré danns le fichier $CUBRID/conf/cubrid_broker.conf).

`dbname`

  Nom de la base de données.

`userid`

  Nom d'utilisateur pour la base de données. Si non fourni, la valeur par défaut est "public".

`passwd`

  Mot de passe pour l'utilisateur. Si non fourni, la valeur par défaut est "".

`new_link`

  Si un second appel est effectué à la fonction cubrid_connect() avec les mêmes arguments, aucune nouvelle connexion ne sera établie, et l'identifiant de la connexion déjà ouverte sera retourné à la place. Le paramètre `new_link` modifie ce comportement et fera que la fonction cubrid_connect() ouvre toujours une nouvelle connexion, y compris si la fonction cubrid_connect() a déjà été appelée avec les mêmes arguments.

### Valeurs de retour

Un identifiant de connexion, lorsque l'opération a été réalisée avec succès, ou `false` si une erreur survient.

### Exemples

Exemple #1 Exemple avec cubrid_connect()

`<?php
printf("%-30s %s\n", "CUBRID PHP Version:", cubrid_version());
printf("\n");
$conn = cubrid_connect("localhost", 33000, "demodb", "dba");
if (!$conn) {
die('Connect Error ('. cubrid_error_code() .')' . cubrid_error_msg());
}
$db_params = cubrid_get_db_parameter($conn);
while (list($param_name, $param_value) = each($db_params)) {
printf("%-30s %s\n", $param_name, $param_value);
}
printf("\n");
$server_info = cubrid_get_server_info($conn);
$client_info = cubrid_get_client_info();
printf("%-30s %s\n", "Server Info:", $server_info);
printf("%-30s %s\n", "Client Info:", $client_info);
printf("\n");
$charset = cubrid_get_charset($conn);
printf("%-30s %s\n", "CUBRID Charset:", $charset);
cubrid_disconnect($conn);
?>`

L'exemple ci-dessus va afficher :

    CUBRID PHP Version:            9.1.0.0001

    PARAM_ISOLATION_LEVEL          3
    LOCK_TIMEOUT                   -1
    MAX_STRING_LENGTH              1073741823
    PARAM_AUTO_COMMIT              1

    Server Info:                   9.1.0.0212
    Client Info:                   9.1.0

    CUBRID Charset:                iso8859-1

### Voir aussi

- cubrid_pconnect() - Ouvre une connexion persistante vers un serveur CUBRID
- cubrid_connect_with_url() - Établit l'environnement pour une connexion au serveur CUBRID
- cubrid_pconnect_with_url() - Ouvre une connexion persistante vers un serveur CUBRID
- cubrid_disconnect() - Ferme la connexion à la base de données
- cubrid_close() - Ferme une connexion CUBRID