db2_client_info
(PECL ibm_db2 >= 1.1.1)
db2_client_info — DB2 データベースクライアントの情報をプロパティに保持するオブジェクトを返す
説明
db2_client_info
( resource $connection
) : object
この関数は、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" という形式の文字列で、 |
DRIVER_VER | string | クライアントのバージョン。"MM.mm.uuuu" という形式の文字列で、
|
ODBC_SQL_CONFORMANCE | string |
クライアントがサポートする ODBC SQL 構文レベル。
|
ODBC_VER | string | ODBC ドライバマネージャがサポートする ODBC のバージョン。
"MM.mm.rrrr" という形式の文字列で、
|
パラメータ
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 "DRIVER_NAME: "; var_dump( $client->DRIVER_NAME ); echo "DRIVER_VER: "; var_dump( $client->DRIVER_VER ); echo "DATA_SOURCE_NAME: "; var_dump( $client->DATA_SOURCE_NAME ); echo "DRIVER_ODBC_VER: "; var_dump( $client->DRIVER_ODBC_VER ); echo "ODBC_VER: "; var_dump( $client->ODBC_VER ); echo "ODBC_SQL_CONFORMANCE: "; var_dump( $client->ODBC_SQL_CONFORMANCE ); echo "APPL_CODEPAGE: "; var_dump( $client->APPL_CODEPAGE ); echo "CONN_CODEPAGE: "; 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)