(PECL ibm_db2 >= 1.1.1)
db2_client_info — Retourne un objet avec des propriétés qui décrivent le client de base de données DB2
$connection
)Cette fonction retourne un objet avec des propriétés en lecture seule qui retournent des informations à propos du client de base de données DB2. La table suivante liste les propriétés du client DB2 :
| Nom Propriété | Type de retour | Description |
|---|---|---|
| APPL_CODEPAGE | entier | L'application est un code page. |
| CONN_CODEPAGE | entier | Le code page pour la connexion courante. |
| DATA_SOURCE_NAME | chaîne de caractères | Le nom source de la donnée (DSN) utilisé pour créer la connexion courante à la base de données. |
| DRIVER_NAME | chaîne de caractères | Le nom de la bibliothèque qui implémente la spécification DB2 Call Level Interface (CLI). |
| DRIVER_ODBC_VER | chaîne de caractères | La version de ODBC que le client DB2 supporte. Ceci retourne une chaîne de caractères "MM.mm" où MM est la version majeure et mm est la version mineure. Le client DB2 retourne toujours "03.51". |
| DRIVER_VER | chaîne de caractères | La version du client, dans la forme d'une chaîne de caractères "MM.mm.uuuu" où MM est la version majeure, mm est la version mineure et uuuu est la mise à jour. Par exemple, "08.02.0001" représente la version majeure 8, la version mineure 2, et la mise à jour 1. |
| ODBC_SQL_CONFORMANCE | chaîne de caractères |
Le niveau de grammaire supporté par le client :
|
| ODBC_VER | chaîne de caractères | La version de ODBC que le gestionnaire de pilote ODBC supporte. Cela retourne une chaîne de caractères "MM.mm.rrrr" où MM est la version majeure, mm est la version mineure et rrrr est la mise à jour. Le client DB2 retourne toujours "03.01.0000". |
connectionSpécifie la connexion cliente DB2 active.
Retourne un objet si l'appel est réussi. Retourne FALSE en cas d'erreur.
Exemple #1 Exemple avec db2_client_info()
Pour récupérer des informations à propos du client, vous devez passer une ressource de connexion de base de données valide à la fonction 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 "Erreur de récupération des informations du client.
Peut-être que votre connexion à la base de données était invalide.";
}
db2_close($conn);
?>
L'exemple ci-dessus va afficher :
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)