PHP Conference Japan 2024

oci_set_module_name

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

oci_set_module_name設定模組名稱

說明

oci_set_module_name(資源 $connection, 字串 $name): 布林值

設定 Oracle 追蹤的模組名稱。

當下次從 PHP 到資料庫發生「往返」時,通常是在執行 SQL 陳述式時,模組名稱會向資料庫註冊。

之後可以從資料庫管理視圖(例如 V$SESSION)查詢名稱。 它可以用於追蹤和監控,例如使用 V$SQLAREADBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE

此值可能會在持久連線中保留。

參數

connection

一個 Oracle 連線識別碼,由 oci_connect()oci_pconnect()oci_new_connect() 返回。

name

使用者選擇的 字串,最長 48 位元組。

返回值

成功時返回 true,失敗時返回 false

範例

範例 #1 設定模組名稱

<?php

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

// 記錄模組
oci_set_module_name($c, 'Home Page');

// 導致往返的程式碼,例如查詢:
$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;

注意事項

注意Oracle 版本需求

當 PHP 連結到 Oracle Database 10g 或更高版本的程式庫時,可以使用此函式。

提示

效能

對於舊版的 OCI8 或 Oracle Database,可以使用 Oracle 的 DBMS_APPLICATION_INFO 套件設定用戶端資訊。這不如使用 oci_set_client_info() 有效率。

警告

往返陷阱

部分(但並非全部)OCI8 函式會導致往返。啟用結果快取時,查詢可能不會發生與資料庫的往返。

參見

新增註釋

使用者貢獻的註釋

此頁面沒有使用者貢獻的註釋。
To Top