Description

db2_client_info(resource $connection): stdClass|false

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 d'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 :

MINIMUM

Supporte le minimum de grammaire SQL d'ODBC.

CORE

Supporte le noyau de grammaire SQL d'ODBC.

EXTENDED

Supporte la grammaire étendue SQL d'ODBC.

ODBC_VER chaîne de caractères La version d'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".

**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 d'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 : MINIMUM Supporte le minimum de grammaire SQL d'ODBC. CORE Supporte le noyau de grammaire SQL d'ODBC. EXTENDED Supporte la grammaire étendue SQL d'ODBC.
ODBC_VER	chaîne de caractères	La version d'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"`.

Liste de paramètres

connection: Spécifie la connexion cliente DB2 active.

Valeurs de retour

Retourne un objet si l'appel est réussi, ou false si une erreur survient

Exemples

Exemple #1 Exemple avec db2_client_info()

Pour récupérer des informations à propos du client, il faut 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

db2_server_info() - Retourne un objet avec des propriétés qui décrivent le serveur de base de données DB2