(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL OCI8 >= 1.4.0)
oci_set_client_info — 設定客戶端資訊
設定 Oracle 追蹤的客戶端資訊。
當下次從 PHP 到資料庫的「往返」發生時,通常是在執行 SQL 陳述式時,客戶端資訊會向資料庫註冊。
用戶端資訊隨後可以從資料庫管理視圖(例如 V$SESSION
)查詢。
該值可能會在持續性連線中保留。
connection(連線)
一個 Oracle 連線識別符號,由 oci_connect()、oci_pconnect() 或 oci_new_connect() 返回。
client_info(用戶端資訊)
使用者選擇的字串,長度最多為 64 個位元組。
範例 #1 設定用戶端資訊
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// 記錄用戶端資訊
oci_set_client_info($c, 'My Application Version 2');
// 導致往返的程式碼,例如查詢:
$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 client // information: sqlplus system/welcome SQL> select client_info from v$session;
注意:Oracle 版本需求
當 PHP 連結到 Oracle Database 10g 或更高版本的程式庫時,可以使用此函式。
使用舊版 OCI8 或 Oracle Database 時,可以使用 Oracle DBMS_APPLICATION_INFO
套件設定用戶端資訊。這比使用 oci_set_client_info() 的效率低。
部分(但並非所有)OCI8 函式會導致往返。啟用結果快取時,查詢可能不會發生與資料庫的往返。