(PECL ibm_db2 >= 1.1.1)
db2_client_info — 傳回一個物件,其屬性描述 DB2 資料庫用戶端
此函式會傳回一個物件,其中包含唯讀屬性,這些屬性會傳回有關 DB2 資料庫用戶端的資訊。下表列出了 DB2 用戶端屬性
屬性名稱 | 傳回類型 | 說明 |
---|---|---|
APPL_CODEPAGE | int(整數) | 應用程式字碼頁。 |
CONN_CODEPAGE | int(整數) | 目前連線的字碼頁。 |
DATA_SOURCE_NAME | string(字串) | 用於建立與資料庫目前連線的資料來源名稱 (DSN)。 |
DRIVER_NAME | string(字串) | 實作 DB2 呼叫層級介面 (CLI) 規格的程式庫名稱。 |
DRIVER_ODBC_VER | string(字串) | DB2 用戶端支援的 ODBC 版本。此屬性會傳回字串「MM.mm」,其中 MM 為主要版本,mm 為次要版本。DB2 用戶端一律傳回「03.51」。 |
DRIVER_VER | string(字串) | 用戶端版本,格式為字串「MM.mm.uuuu」,其中 MM 為主要版本,mm 為次要版本,uuuu 為更新版本。例如,「08.02.0001」代表主要版本 8、次要版本 2、更新版本 1。 |
ODBC_SQL_CONFORMANCE | string(字串) |
用戶端支援的 ODBC SQL 語法層級
|
ODBC_VER | string(字串) | ODBC 驅動程式管理員支援的 ODBC 版本。此屬性會傳回字串「MM.mm.rrrr」,其中 MM 為主要版本,mm 為次要版本,rrrr 為發行版本。DB2 用戶端一律傳回「03.01.0000」。 |
connection(連線)
指定有效的 DB2 用戶端連線。
呼叫成功時傳回一個物件,失敗時傳回 false
範例 #1 db2_client_info() 範例
要擷取有關用戶端的資訊,您必須將有效的資料庫連線資源傳遞給 db2_client_info()。
<?php
$conn = db2_connect( 'SAMPLE', 'db2inst1', 'ibmdb2' );
$client = db2_client_info( $conn );
if ($client) {
echo "驅動程式名稱:"; var_dump( $client->DRIVER_NAME );
echo "驅動程式版本:"; var_dump( $client->DRIVER_VER );
echo "資料來源名稱:"; var_dump( $client->DATA_SOURCE_NAME );
echo "ODBC 驅動程式版本:"; var_dump( $client->DRIVER_ODBC_VER );
echo "ODBC 版本:"; var_dump( $client->ODBC_VER );
echo "ODBC SQL 一致性:"; var_dump( $client->ODBC_SQL_CONFORMANCE );
echo "應用程式字碼頁:"; var_dump( $client->APPL_CODEPAGE );
echo "連線字碼頁:"; var_dump( $client->CONN_CODEPAGE );
}
else {
echo "擷取用戶端資訊時發生錯誤。
可能是您的資料庫連線無效。";
}
db2_close($conn);
?>
以上範例將輸出
DRIVER_NAME: string(8) "libdb2.a" DRIVER_VER: string(10) "08.02.0001" DATA_SOURCE_NAME: string(6) "SAMPLE" DRIVER_ODBC_VER: string(5) "03.51" ODBC_VER: string(10) "03.01.0000" ODBC_SQL_CONFORMANCE: string(8) "EXTENDED" APPL_CODEPAGE: int(819) CONN_CODEPAGE: int(819)