函数名:oci_new_connect()
适用版本:PHP 4, PHP 5, PHP 7
用法:oci_new_connect()函数用于创建一个到Oracle数据库的新连接。它返回一个连接资源,用于在后续的数据库操作中使用。
语法:resource oci_new_connect ( string $username, string $password [, string $connection_string [, string $character_set [, int $session_mode ]]] )
参数:
- username: 连接Oracle数据库的用户名。
- password: 连接Oracle数据库的密码。
- connection_string(可选): 指定连接Oracle数据库的服务名称或TNS名称。如果未提供,则使用默认的本地连接。
- character_set(可选): 指定连接的字符集。如果未提供,则使用Oracle客户端的默认字符集。
- session_mode(可选): 指定连接模式。默认为OCI_DEFAULT。
返回值:成功时返回一个连接资源(resource),失败时返回false。
示例:
<?php
// 连接到本地的Oracle数据库
$conn = oci_new_connect('username', 'password');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
// 执行查询
$sql = 'SELECT * FROM employees';
$stid = oci_parse($conn, $sql);
oci_execute($stid);
// 输出查询结果
while (($row = oci_fetch_array($stid, OCI_ASSOC)) != false) {
foreach ($row as $item) {
echo $item . " ";
}
echo "<br>";
}
// 关闭连接
oci_free_statement($stid);
oci_close($conn);
?>
以上示例代码演示了如何使用oci_new_connect()函数连接到Oracle数据库,并执行简单的查询操作。首先,使用正确的用户名和密码创建一个连接资源。然后,使用oci_parse()函数准备一个查询语句,并使用oci_execute()函数执行查询。最后,使用oci_fetch_array()函数获取查询结果,并使用oci_free_statement()函数释放资源,最后使用oci_close()函数关闭连接。
注意:在使用oci_new_connect()函数连接Oracle数据库时,请确保已经安装了Oracle客户端,并且相关的Oracle扩展已经启用。