(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'.
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.
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");
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 :
Version de CUBRID PHP : 8.4.1.0001 PARAM_ISOLATION_LEVEL 3 LOCK_TIMEOUT 0 MAX_STRING_LENGTH 1073741823 PARAM_AUTO_COMMIT 0 Infos Server : 8.4.1.0508 Infos Client : 8.4.1 Jeux de caractères CUBRID : iso8859-1