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

函数名：oci_error()

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

函数说明：oci_error() 函数用于获取最近一次 Oracle 函数或语句执行的错误信息。

语法：oci_error ( resource $resource = ? ) : array|false

参数：

• resource：可选参数，Oracle 的连接资源（由 oci_connect() 或 oci_pconnect() 函数返回）。

返回值：

• 当成功时，返回一个包含错误信息的关联数组，其中包括错误代码（code）、错误信息（message）、错误位置（offset）和错误语句（sqltext）等字段。
• 当没有错误时，返回 false。

示例：

<?php
$conn = oci_connect("username", "password", "localhost/XE");

if (!$conn) {
    $error = oci_error();
    echo "连接Oracle数据库失败：" . $error['message'];
    exit;
}

$stid = oci_parse($conn, "SELECT * FROM employees");
if (!$stid) {
    $error = oci_error($conn);
    echo "解析SQL语句失败：" . $error['message'];
    exit;
}

$result = oci_execute($stid);
if (!$result) {
    $error = oci_error($stid);
    echo "执行SQL语句失败：" . $error['message'];
    exit;
}

oci_free_statement($stid);
oci_close($conn);
?>

以上示例展示了如何使用 oci_error() 函数来获取 Oracle 数据库连接、SQL语句解析和执行过程中的错误信息。如果发生错误，将会输出错误信息到页面上。注意在实际使用中，应该根据具体情况进行错误处理，例如记录日志或返回错误给用户。