(PECL CUBRID >= 8.3.1)
cubrid_connect — 開啟與 CUBRID 伺服器的連線
$host
,$port
,$dbname
,$userid
= ?,$passwd
= ?,$new_link
= false
cubrid_connect() 函式用於建立連線到伺服器的環境,使用伺服器位址、埠號、資料庫名稱、使用者名稱和密碼。如果未提供使用者名稱和密碼,則預設會建立「PUBLIC」連線。
host
CUBRID CAS 伺服器的主機名稱或 IP 位址。
port
CUBRID CAS 伺服器的埠號(在 $CUBRID/conf/cubrid_broker.conf 中設定的 BROKER_PORT)。
dbname
資料庫名稱。
userid
資料庫的使用者名稱。如果未提供,則預設值為「public」。
passwd
使用者密碼。如果未提供,則預設值為 ""。
new_link
如果使用相同的參數再次呼叫 cubrid_connect(),則不會建立新的連線,而是會傳回已開啟連線的連線識別碼。new_link
參數會修改此行為,使 cubrid_connect() 永遠開啟新的連線,即使先前已使用相同參數呼叫過 cubrid_connect()。
成功時傳回連線識別碼,失敗時傳回 false
。
範例 #1 cubrid_connect() 範例
<?php
printf("%-30s %s\n", "CUBRID PHP 版本:", cubrid_version());
printf("\n");
$conn = cubrid_connect("localhost", 33000, "demodb", "dba");
if (!$conn) {
die('連線錯誤 ('. 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", "伺服器資訊:", $server_info);
printf("%-30s %s\n", "客戶端資訊:", $client_info);
printf("\n");
$charset = cubrid_get_charset($conn);
printf("%-30s %s\n", "CUBRID 字元集:", $charset);
cubrid_disconnect($conn);
?>
上述範例將輸出
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