(PECL ibm_db2 >= 1.1.1)
db2_client_info — Devuelve un objeto cuyas propiedades describen cliente de una base de datos DB2
Esta función devuelve un objeto, con propiedades de sólo lectura, con información sobre el cliente de base de datos DB2. La siguiente tabla lista las propiedades del cliente DB2:
Nombre de la propiedad | Tipo devuelto | Descripción |
---|---|---|
APPL_CODEPAGE | int | Código de página de la aplicación. |
CONN_CODEPAGE | int | Código de página de la conexión activa. |
DATA_SOURCE_NAME | string | Nombre fuente de datos (DSN) usado para crear la conexión actual a la base de datos. |
DRIVER_NAME | string | Nombre de la biblioteca que implementa la especificación de la Interfaz a nivel de Llamada (CLI) de DB2. |
DRIVER_ODBC_VER | string | Versión de ODBC que soporta el cliente DB2. Devuelve un string del tipo "MM.mm" donde MM es la versión principal y mm la secundaria. El cliente DB2 siempre devuelve "03.51". |
DRIVER_VER | string | Versión del driver, en forma de string "MM.mm.uuuu" donde MM es la versión principal, mm es la versión secundaria, y uuuu la actualización. Por ejemplo, "08.02.0001" representa la versión principal 8, versión secundaria 2, actualización 1. |
ODBC_SQL_CONFORMANCE | string |
Nivel de gramática SQL ODBC soportado por el cliente.
|
ODBC_VER | string | Versión de ODBC que soporta el gestor de drivers de ODBC. Devuelve un strong del tipo "MM.mm.rrrr" donde MM es la versión principal, mm es la versión secundaria, y rrrr es la edición. El cliente DB2 siempre devuelve "03.01.0000". |
connection
Especifica una conexión de cliente DB2 activa.
Devuelve un objeto en caso de éxito. Devuelve false
en caso de error.
Ejemplo #1 Ejemplo de db2_client_info()
Para consultar información del cliente, se debe proporcionar un recurso de conexión a base de datos válido a 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 consultar información del cliente.
Es posible que la conexión a base de datos sea inválida.";
}
db2_close($conn);
?>
El resultado del ejemplo sería:
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)