函数名称: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' 是一个示例,实际应根据实际情况修改为正确的连接字符串。