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

# db2_client_info

(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

### Description

function 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 de la propriété | Type de retour | Description
--- | --- | ---
APPL_CODEPAGE | entier | Le code page de l'application.
CONN_CODEPAGE | entier | Le code page pour la connexion courante.
DATA_SOURCE_NAME | chaîne de caractères | Le nom de la source de données (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 SQL ODBC 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 la 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open