cubrid_pconnect

(PECL CUBRID >= 8.3.1)

cubrid_pconnect — Ouvre une connexion persistante vers un serveur CUBRID

Description

cubrid_pconnect(
    string $host,
    int $port,
    string $dbname,
    string $userid = ?,
    string $passwd = ?
): resource

Établit une connexion persistante vers un serveur CUBRID.

cubrid_pconnect() agit de la même façon que cubrid_connect() avec deux différences majeures.

Tout d'abord, lors de la connexion, la fonction tentera d'abord de trouver un lien (persistant) déjà ouvert avec le même nom d'hôte, sur le même port, utilisant la même base de données dbname ainsi que le même userid. Si un tel lien est trouvé, son identifiant sera retourné au lieu d'ouvrir une nouvelle connexion.

Ensuite, la connexion vers le serveur SQL ne sera pas fermée lorsque la fin du script est atteinte. Au lieu de cela, le lien restera ouvert pour une utilisation future (cubrid_close() ou cubrid_disconnect() ne fermera pas les liens établis avec cubrid_pconnect()).

Ce type de lien était appelé auparavant 'persistant'.

Liste de paramètres

host: Nom de l'hôte ou adresse IP du serveur CUBRID CAS.
port: Numéro du port du serveur CUBRID CAS (BROKER_PORT configuré dans $CUBRID/conf/cubrid_broker.conf).
dbname: Nom de la base de données.
userid: Nom d'utilisateur pour la base de données.
passwd: Mot de passe à associer avec le nom d'utilisateur.

Valeurs de retour

Identifiant de connexion en cas de succès, ou false si une erreur survient.

Exemples

Exemple #1 Exemple avec cubrid_connect()

<?php
printf("%-30s %s\n", "version de CUBRID PHP :", cubrid_version());

printf("\n");

$conn = cubrid_pconnect("localhost", 33000, "demodb", "dba");

if (!$conn) {
    die('Erreur de connexion ('. 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", "Infos Server :", $server_info);
printf("%-30s %s\n", "Infos Client:", $client_info);

printf("\n");

$charset = cubrid_get_charset($conn);

printf("%-30s %s\n", "Jeux de caractères CUBRID :", $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_connect() - Ouvre une connexion au 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