Devuelve un objeto con propiedades que describen el cliente de base de datos DB2

# db2_client_info

(PECL ibm_db2 >= 1.1.1)

db2_client_info — Devuelve un objeto con propiedades que describen el cliente de base de datos DB2

### Descripción

function db2_client_info(resource `$connection`): stdClass|false

Esta función devuelve un objeto con propiedades en solo lectura que proporcionan información sobre el cliente de base de datos DB2. La tabla siguiente lista las propiedades del cliente DB2:

Propiedades del cliente DB2
Nombre Propiedad | Tipo de retorno | Descripción
--- | --- | ---
APPL_CODEPAGE | int | La aplicación es un código de página.
CONN_CODEPAGE | int | El código de página para la conexión actual.
DATA_SOURCE_NAME | string | El nombre de la fuente de datos (DSN) utilizado para crear la conexión actual a la base de datos.
DRIVER_NAME | string | El nombre de la biblioteca que implementa la especificación `DB2 Call Level Interface` (CLI).
DRIVER_ODBC_VER | string | La versión de ODBC que el cliente DB2 soporta. Esto devuelve una string `"MM.mm"` donde MM es la versión mayor y mm es la versión menor. El cliente DB2 siempre devuelve `"03.51"`.
DRIVER_VER | string | La versión del cliente, en la forma de una string `"MM.mm.uuuu"` donde MM es la versión mayor, mm es la versión menor y uuuu es la actualización. Por ejemplo, `"08.02.0001"` representa la versión mayor 8, la versión menor 2, y la actualización 1.
ODBC_SQL_CONFORMANCE | string | El nivel de sintaxis soportado por el cliente: MINIMUM Soporta el mínimo de sintaxis SQL de ODBC. CORE Soporta el núcleo de sintaxis SQL de ODBC. EXTENDED Soporta la sintaxis extendida SQL de ODBC.
ODBC_VER | string | La versión de ODBC que el administrador de controladores ODBC soporta. Esto devuelve una string `"MM.mm.rrrr"` donde MM es la versión mayor, mm es la versión menor y rrrr es la actualización. El cliente DB2 siempre devuelve `"03.01.0000"`.

### Parámetros

`connection`
  Especifica la conexión cliente DB2 activa.

### Valores devueltos

Devuelve un objeto si la llamada es exitosa, o `false` si ocurre un error

### Ejemplos

Ejemplo #1 Ejemplo con db2_client_info()

Para obtener información sobre el cliente, se debe pasar un recurso de conexión de base de datos válido a la función 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 "Error al obtener la información del cliente.
         Quizás su conexión a la base de datos era inválida.";
    }
    db2_close($conn);

    ?>

El ejemplo anterior mostrará:

    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)

### Ver también

- db2_server_info() - Devuelve un objeto con propiedades que describen el servidor de base de datos DB2

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