2024 年 PHP Conference Japan

db2_client_info

(PECL ibm_db2 >= 1.1.1)

db2_client_info傳回一個物件,其屬性描述 DB2 資料庫用戶端

說明

db2_client_info(資源 $connection): stdClass|false

此函式會傳回一個物件,其中包含唯讀屬性,這些屬性會傳回有關 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 語法層級

MINIMUM(最小)

支援最小的 ODBC SQL 語法。

CORE(核心)

支援核心 ODBC SQL 語法。

EXTENDED(擴充)

支援擴充 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)

另請參閱

新增註釋

使用者貢獻的註釋

此頁面沒有使用者貢獻的註釋。
To Top