(PECL CUBRID >= 8.3.1)
cubrid_pconnect — Ouvre une connexion persistante vers un serveur CUBRID
$host
, int $port
, string $dbname
[, string $userid
[, string $passwd
]] )É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 MySQL ne sera pas fermée lorsque la fin du scripts est atteint. 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 'persistante'.
hostNom de l'hôte ou adresse IP du serveur CUBRID CAS.
portNuméro du port du serveur CUBRID CAS (BROKER_PORT configuré dans $CUBRID/conf/cubrid_broker.conf).
dbnameNom de la base de données.
useridNom d'utilisateur pour la base de données.
passwdMot de passe à associer avec le nom d'utilisateur.
Identifiant de connexion en cas de succès.
FALSE si une erreur survient.
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