CUBRID_PCONNECT(3) 1 CUBRID_PCONNECT(3)
cubrid_pconnect - Open a persistent connection to a CUBRID server
SYNOPSIS
resource cubrid_pconnect (string $host, int $port, string $dbname, [string $userid], [string $passwd])
DESCRIPTION
Establishes a persistent connection to a CUBRID server.
cubrid_pconnect(3) acts very much like cubrid_connect(3) with two major differences.
First, when connecting, the function would first try to find a (persistent) link that's already open with the same host, port, dbname and
userid. If one is found, an identifier for it will be returned instead of opening a new connection.
Second, the connection to the SQL server will not be closed when the execution of the script ends. Instead, the link will remain open for
future use (cubrid_close(3) or cubrid_disconnect(3) will not close links established by cubrid_pconnect(3)).
This type of link is therefore called 'persistent'.
PARAMETERS
o $host
-Host name or IP address of CUBRID CAS server.
o $port
-Port number of CUBRID CAS server (BROKER_PORT configured in $CUBRID/conf/cubrid_broker.conf).
o $dbname
-Name of database.
o $userid
-User name for the database.
o $passwd
-User password.
RETURN VALUES
Connection identifier, when process is successful.
FALSE, when process is unsuccessful.
EXAMPLES
Example #1
cubrid_connect(3) example
<?php
printf("%-30s %s
", "CUBRID PHP Version:", cubrid_version());
printf("
");
$conn = cubrid_pconnect("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
", $param_name, $param_value);
}
printf("
");
$server_info = cubrid_get_server_info($conn);
$client_info = cubrid_get_client_info();
printf("%-30s %s
", "Server Info:", $server_info);
printf("%-30s %s
", "Client Info:", $client_info);
printf("
");
$charset = cubrid_get_charset($conn);
printf("%-30s %s
", "CUBRID Charset:", $charset);
cubrid_disconnect($conn);
?>
The above example will output:
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
SEE ALSO
cubrid_connect(3), cubrid_connect_with_url(3), cubrid_pconnect_with_url(3), cubrid_disconnect(3), cubrid_close(3).
PHP Documentation Group CUBRID_PCONNECT(3)