cubrid_pconnect
(PECL CUBRID >= 8.3.1)
cubrid_pconnect — Ouvre une connexion persistante vers un serveur CUBRID
Description
$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'.
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.
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