oci_set_module_name

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

oci_set_module_nameSets the module name

˵��

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

Sets the module name for Oracle tracing.

The module name is registered with the database when the next 'round-trip' from PHP to the database occurs, typically when an SQL statement is executed.

The name can subsequently be queried from database administration views such as V$SESSION. It can be used for tracing and monitoring such as with V$SQLAREA and DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE.

The value may be retained across persistent connections.

����

connection

Oracle ���ӱ�ʶ���� oci_connect()��oci_pconnect()���� oci_new_connect() ���ء�

module_name

User chosen string up to 48 bytes long.

����ֵ

�ɹ�ʱ���� TRUE�� ������ʧ��ʱ���� FALSE��

ע��

Note: Oracle �汾����

�� PHP ���� Oracle ���ݿ� 10g �����°汾�� ��չ������ʱ���˺������á�

Tip

����

ʹ�þɰ�� OCI8 �� ORACLE ���ݿ� ����ʹ�� Oracle DBMS_APPLICATION_INFO �������ÿͻ�����Ϣ�����ʹ�� oci_set_client_info() �ϵ�Ч��

Caution

Roundtrip Gotcha

һЩ OCI8 �����ᵼ�� Roundtrips. �����ݿ���˵�����ý������ʱ����ѯ���ܲ�����Roundtrips��

����

Example #1 Setting the module name

<?php

$c 
oci_connect('hr''welcome''localhost/XE');

// Record the module
oci_set_module_name($c'Home Page');

// Code that causes a round-trip, for example a query:
$s oci_parse($c'select * from dual');
oci_execute($s);
oci_fetch_all($s$res);

sleep(30);
?>
// While the script is running, the administrator can see the
// modules in use:

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

�μ�