Fonctions IBM DB2
PHP Manual

db2_client_info

(PECL ibm_db2 >= 1.1.1)

db2_client_infoRetourne un objet avec des propriétés qui décrivent le client de base de données DB2

Description

object db2_client_info ( resource $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 :

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"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"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 :

MINIMUM

Supporte le minimum de grammaire SQL de ODBC.

CORE

Supporte le noyau de grammaire SQL de ODBC.

EXTENDED

Supporte la grammaire étendue SQL de ODBC.

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"MM est la version majeure, mm est la version mineure et rrrr est la mise à jour. Le client DB2 retourne toujours "03.01.0000".

Liste de paramètres

connection

Spécifie la connexion cliente DB2 active.

Valeurs de retour

Retourne un objet si l'appel est réussi. Retourne FALSE en cas d'erreur.

Exemples

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)

Voir aussi


Fonctions IBM DB2
PHP Manual