[函数]oci_pconnect()函数—用法及示例

函数名称：oci_pconnect()

适用版本：PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8

函数描述：oci_pconnect() 函数用于建立一个持久的连接到 Oracle 数据库。

语法：resource oci_pconnect(string $username, string $password, ?string $connection_string = null, ?string $character_set = null, ?int $session_mode = null)

参数：

• $username: Oracle 用户名。
• $password: Oracle 密码。
• $connection_string (可选): Oracle 连接字符串，用于指定要连接的 Oracle 数据库和其他连接选项。如果未提供，将使用默认的连接选项。
• $character_set (可选): 字符集名称，用于指定连接的字符集。如果未提供，将使用默认的字符集。
• $session_mode (可选): 会话模式，用于指定连接的模式。如果未提供，将使用默认的会话模式。

返回值：成功时返回一个表示 Oracle 连接的资源标识符，失败时返回 false。

示例：

$conn = oci_pconnect('username', 'password', 'localhost/XE');
if (!$conn) {
    $e = oci_error();
    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}

// 执行 SQL 查询
$sql = 'SELECT * FROM employees';
$stmt = oci_parse($conn, $sql);
oci_execute($stmt);

// 获取查询结果
while ($row = oci_fetch_array($stmt, OCI_ASSOC)) {
    echo $row['EMPLOYEE_NAME'] . '<br>';
}

// 释放资源
oci_free_statement($stmt);
oci_close($conn);

以上示例演示了使用 oci_pconnect() 函数建立一个持久的 Oracle 连接，并执行一条查询语句，然后遍历结果集并输出每个员工的姓名。最后，释放语句和关闭连接。

请注意，示例中的连接字符串 'localhost/XE' 是一个示例，实际应根据实际情况修改为正确的连接字符串。