PHP 8.4.24 Released!

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

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 int Le code page de l'application.
CONN_CODEPAGE int Le code page pour la connexion courante.
DATA_SOURCE_NAME string Le nom de la source de données (DSN) utilisé pour créer la connexion courante à la base de données.
DRIVER_NAME string Le nom de la bibliothèque qui implémente la spécification DB2 Call Level Interface (CLI).
DRIVER_ODBC_VER string La version d'ODBC que le client DB2 supporte. Ceci retourne une string "MM.mm"MM est la version majeure et mm est la version mineure. Le client DB2 retourne toujours "03.51".
DRIVER_VER string La version du client, dans la forme d'une string "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 string

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 string La version d'ODBC que le gestionnaire de pilote ODBC supporte. Cela retourne une string "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, 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
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top