oci_set_client_info

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

oci_set_client_info设置客户端信息

描述

oci_set_client_info(resource $connection, string $client_info): bool

设置 Oracle 跟踪的客户端信息。

当 PHP 与数据库的下一个“往返”发生时(通常在执行 SQL 语句时),客户端信息将注册到数据库。

随后可以从数据库管理视图(如 V$SESSION)查询客户端信息。

该值可能会在持久连接中保留。

参数

connection

一个 Oracle 连接标识符,由 oci_connect()oci_pconnect()oci_new_connect() 返回。

client_info

用户选择的字符串,长度不超过 64 字节。

返回值

成功时返回 true,失败时返回 false

示例

示例 #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 与从 10g 版本开始的 Oracle 数据库库链接时,此函数可用。

提示

性能

对于较旧版本的 OCI8 或 Oracle 数据库,可以使用 Oracle DBMS_APPLICATION_INFO 包设置客户端信息。这不如使用 oci_set_client_info() 高效。

警告

往返注意事项

一些但并非所有 OCI8 函数都会导致往返。当启用结果缓存时,查询可能不会发生与数据库的往返。

参见

添加注释

用户贡献注释

此页面没有用户贡献注释。
To Top