# oci_set_module_name

(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL OCI8 >= 1.4.0)

oci_set_module_name — Establece el nombre de un módulo

### Descripción

oci_set_module_name(resource `$connection`, string `$module_name`): bool

Establece el nombre de un módulo para el rastreo de Oracle.

El nombre del módulo se registra con la base de datos cuando ocurra el siguiente "viaje de ida y vuelta" desde PHP a la base de datos, normalemnte cuando una sentencia SQL es ejecutada.

El nombre del módulo puede ser consultado posteriormente desde una vista de administración de la base de datos como `V$SESSION`. Se puede usar para rastrear y monitorizar como con `V$SQLAREA` y `DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE`.

El valor podría manterse entre conexiones persistentes.

### Parámetros

`connection`

  Un identificador de conexión de Oracle, devuelto por oci_connect(), oci_pconnect(), o oci_new_connect().

`module_name`

  El string elegido por el usuario, hasta 48 bytes de longitud.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Notas

> Nota: Requisito de versión de Oracle

> Esta función esta disponible cuando PHP está vinculado con bibliotecas de Oracle Database de la versión 10g en adelante.

Sugerencia

# Rendimiento

Con versiones antiguas de OCI8 o de Oracle Database, se puede establecer la información del cliente usando el paquete `DBMS_APPLICATION_INFO` de Oracle. Esto es menos eficiente que utilizar oci_set_client_info().

Precaución

# Problema con los viajes de ida y vuelta

Algunas, pero no todas, las funciones de OCI8 causan viajes de ida y vuelta. Estos podrían no ocurrir con las consultas cuando está habilitado el almacenamiento en caché de resultados.

### Ejemplos

Ejemplo #1 Establecer el nombre del módulo

`<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Grabar el módulo
oci_set_module_name($c, 'Home Page');
// Código que causa un viaje de ida y vuelta, por ejemplo una consulta:
$s = oci_parse($c, 'select * from dual');
oci_execute($s);
oci_fetch_all($s, $res);
sleep(30);
?>`

    // Mientras el script se esté ejecutando, el administrador puede ver el
    // módulo en uso:

    sqlplus system/welcome
    SQL> select module from v$session;

### Ver también

- oci_set_action() - Establece el nombre de una acción
- oci_set_client_info() - Establece la información del cliente
- oci_set_client_identifier() - Establece el identificador del cliente